@undefineds.co/drizzle-solid 0.2.6

package/dist/esm/core/solid-n3-client.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SolidN3Client - 轻量级 Solid Pod 客户端
+ *
+ * 使用 N3.js + 原生 SPARQL UPDATE 替代 Comunica
+ *
+ * 架构:
+ * - 查询: HTTP GET → JSON-LD → N3 Store → 本地 SPARQL 查询
+ * - 修改: SPARQL UPDATE → HTTP PATCH → Solid Pod
+ */
+import { Store, Quad } from 'n3';
+export interface QueryResult {
+    bindings: Record<string, string>[];
+}
+export interface SparqlBinding {
+    [variable: string]: {
+        type: 'uri' | 'literal' | 'bnode';
+        value: string;
+        datatype?: string;
+        'xml:lang'?: string;
+    };
+}
+export declare class SolidN3Client {
+    private defaultFetch;
+    private cache;
+    private cacheTimeout;
+    constructor(defaultFetch?: typeof globalThis.fetch);
+    /**
+     * 执行 SPARQL SELECT 查询
+     * 通过 HTTP GET 获取数据，然后在本地 N3 Store 中查询
+     */
+    query(endpoint: string, sparqlQuery: string): Promise<QueryResult>;
+    /**
+     * 执行 SPARQL UPDATE 操作
+     * 直接发送到 Solid Pod
+     */
+    update(endpoint: string, sparqlUpdate: string): Promise<void>;
+    /**
+     * 获取资源的 N3 Store（带缓存）
+     */
+    private getResourceStore;
+    /**
+     * 解析 JSON-LD 到 N3 Store
+     */
+    private parseJsonLd;
+    /**
+     * 处理单个 JSON-LD 项目
+     */
+    private processJsonLdItem;
+    /**
+     * 在本地 Store 中执行 SPARQL 查询
+     */
+    private executeLocalQuery;
+    /**
+     * 从 SPARQL 查询中提取需要访问的资源
+     */
+    private extractResourcesFromQuery;
+    /**
+     * 简化的 SPARQL SELECT 解析器
+     */
+    private parseSparqlSelect;
+    /**
+     * 获取解析器格式
+     */
+    private getParserFormat;
+    /**
+     * 解析相对 URI
+     */
+    private resolveUri;
+    /**
+     * 清除缓存
+     */
+    private invalidateCache;
+    /**
+     * 清除所有缓存
+     */
+    clearCache(): void;
+    /**
+     * 便捷方法：获取资源的所有三元组
+     */
+    getResource(resourceUrl: string): Promise<Quad[]>;
+    /**
+     * 便捷方法：将 Store 序列化为 Turtle
+     */
+    serializeToTurtle(store: Store): Promise<string>;
+}
+//# sourceMappingURL=solid-n3-client.d.ts.map

package/dist/esm/core/solid-n3-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid-n3-client.d.ts","sourceRoot":"","sources":["../../../src/core/solid-n3-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAA+B,IAAI,EAAE,MAAM,IAAI,CAAC;AAK9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,qBAAa,aAAa;IAIZ,OAAO,CAAC,YAAY;IAHhC,OAAO,CAAC,KAAK,CAA+D;IAC5E,OAAO,CAAC,YAAY,CAAiB;gBAEjB,YAAY,0BAAQ;IAExC;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAexE;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnE;;OAEG;YACW,gBAAgB;IA6C9B;;OAEG;YACW,WAAW;IAgBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmCzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAKvD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAYvD"}

package/dist/esm/core/solid-n3-client.js

@@ -0,0 +1,275 @@
+/**
+ * SolidN3Client - 轻量级 Solid Pod 客户端
+ *
+ * 使用 N3.js + 原生 SPARQL UPDATE 替代 Comunica
+ *
+ * 架构:
+ * - 查询: HTTP GET → JSON-LD → N3 Store → 本地 SPARQL 查询
+ * - 修改: SPARQL UPDATE → HTTP PATCH → Solid Pod
+ */
+import { Store, Parser, Writer, DataFactory } from 'n3';
+import { fetch } from '@inrupt/universal-fetch';
+const { namedNode, literal, quad } = DataFactory;
+export class SolidN3Client {
+    constructor(defaultFetch = fetch) {
+        this.defaultFetch = defaultFetch;
+        this.cache = new Map();
+        this.cacheTimeout = 5 * 60 * 1000; // 5分钟缓存
+    }
+    /**
+     * 执行 SPARQL SELECT 查询
+     * 通过 HTTP GET 获取数据，然后在本地 N3 Store 中查询
+     */
+    async query(endpoint, sparqlQuery) {
+        // 解析 SPARQL 查询以确定需要访问的资源
+        const resources = this.extractResourcesFromQuery(sparqlQuery, endpoint);
+        // 获取所有相关资源的数据
+        const store = new Store();
+        for (const resource of resources) {
+            const resourceStore = await this.getResourceStore(resource);
+            store.addQuads(resourceStore.getQuads(null, null, null, null));
+        }
+        // 在本地执行 SPARQL 查询
+        return this.executeLocalQuery(store, sparqlQuery);
+    }
+    /**
+     * 执行 SPARQL UPDATE 操作
+     * 直接发送到 Solid Pod
+     */
+    async update(endpoint, sparqlUpdate) {
+        const response = await this.defaultFetch(endpoint, {
+            method: 'PATCH',
+            headers: {
+                'Content-Type': 'application/sparql-update',
+            },
+            body: sparqlUpdate,
+        });
+        if (!response.ok) {
+            throw new Error(`SPARQL UPDATE failed: ${response.status} ${response.statusText}`);
+        }
+        // 清除相关缓存
+        this.invalidateCache(endpoint);
+    }
+    /**
+     * 获取资源的 N3 Store（带缓存）
+     */
+    async getResourceStore(resourceUrl) {
+        // 检查缓存
+        const cached = this.cache.get(resourceUrl);
+        if (cached && Date.now() - cached.timestamp < this.cacheTimeout) {
+            return cached.store;
+        }
+        // 获取资源数据
+        const response = await this.defaultFetch(resourceUrl, {
+            headers: {
+                'Accept': 'text/turtle, application/ld+json, application/n-triples',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch resource: ${response.status} ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type') || '';
+        const data = await response.text();
+        // 解析为 N3 Store
+        const store = new Store();
+        const parser = new Parser({
+            baseIRI: resourceUrl,
+            format: this.getParserFormat(contentType)
+        });
+        try {
+            const quads = parser.parse(data);
+            store.addQuads(quads);
+        }
+        catch (error) {
+            // 如果是 JSON-LD，尝试转换
+            if (contentType.includes('json')) {
+                await this.parseJsonLd(data, store, resourceUrl);
+            }
+            else {
+                throw new Error(`Failed to parse resource: ${error}`);
+            }
+        }
+        // 缓存结果
+        this.cache.set(resourceUrl, { store, timestamp: Date.now() });
+        return store;
+    }
+    /**
+     * 解析 JSON-LD 到 N3 Store
+     */
+    async parseJsonLd(jsonData, store, baseUri) {
+        try {
+            const jsonLd = JSON.parse(jsonData);
+            if (Array.isArray(jsonLd)) {
+                for (const item of jsonLd) {
+                    this.processJsonLdItem(item, store, baseUri);
+                }
+            }
+            else {
+                this.processJsonLdItem(jsonLd, store, baseUri);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON-LD: ${error}`);
+        }
+    }
+    /**
+     * 处理单个 JSON-LD 项目
+     */
+    processJsonLdItem(item, store, baseUri) {
+        if (!item['@id'])
+            return;
+        const subject = namedNode(this.resolveUri(item['@id'], baseUri));
+        // 处理类型
+        if (item['@type']) {
+            const types = Array.isArray(item['@type']) ? item['@type'] : [item['@type']];
+            for (const type of types) {
+                store.addQuad(quad(subject, namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'), namedNode(type)));
+            }
+        }
+        // 处理其他属性
+        for (const [predicate, values] of Object.entries(item)) {
+            if (predicate === '@id' || predicate === '@type')
+                continue;
+            const predicateNode = namedNode(predicate);
+            const valueArray = Array.isArray(values) ? values : [values];
+            for (const value of valueArray) {
+                let objectNode;
+                if (typeof value === 'object' && value !== null) {
+                    if (value['@id']) {
+                        objectNode = namedNode(this.resolveUri(value['@id'], baseUri));
+                    }
+                    else if (value['@value'] !== undefined) {
+                        objectNode = literal(value['@value'], value['@type'] || value['@language']);
+                    }
+                    else {
+                        continue;
+                    }
+                }
+                else {
+                    objectNode = literal(String(value));
+                }
+                store.addQuad(quad(subject, predicateNode, objectNode));
+            }
+        }
+    }
+    /**
+     * 在本地 Store 中执行 SPARQL 查询
+     */
+    executeLocalQuery(store, sparqlQuery) {
+        // 这里是一个简化的 SPARQL 解析器
+        // 实际项目中可以使用 sparqljs 或类似库
+        const query = this.parseSparqlSelect(sparqlQuery);
+        const bindings = [];
+        // 简单的三元组模式匹配
+        for (const pattern of query.patterns) {
+            const quads = store.getQuads(pattern.subject ? namedNode(pattern.subject) : null, pattern.predicate ? namedNode(pattern.predicate) : null, pattern.object ? (pattern.object.startsWith('http') ? namedNode(pattern.object) : literal(pattern.object)) : null, null);
+            for (const quad of quads) {
+                const binding = {};
+                if (pattern.subject?.startsWith('?')) {
+                    binding[pattern.subject] = quad.subject.value;
+                }
+                if (pattern.predicate?.startsWith('?')) {
+                    binding[pattern.predicate] = quad.predicate.value;
+                }
+                if (pattern.object?.startsWith('?')) {
+                    binding[pattern.object] = quad.object.value;
+                }
+                bindings.push(binding);
+            }
+        }
+        return { bindings };
+    }
+    /**
+     * 从 SPARQL 查询中提取需要访问的资源
+     */
+    extractResourcesFromQuery(sparqlQuery, defaultEndpoint) {
+        // 简化实现：假设查询的是默认端点
+        // 实际实现中需要解析 FROM 子句等
+        return [defaultEndpoint];
+    }
+    /**
+     * 简化的 SPARQL SELECT 解析器
+     */
+    parseSparqlSelect(sparqlQuery) {
+        // 这是一个非常简化的解析器
+        // 实际项目中应该使用 sparqljs
+        const patterns = [];
+        // 提取 WHERE 子句中的三元组模式
+        const whereMatch = sparqlQuery.match(/WHERE\s*\{([^}]+)\}/i);
+        if (whereMatch) {
+            const whereClause = whereMatch[1];
+            const triplePattern = /(\S+)\s+(\S+)\s+(\S+)\s*\./g;
+            let match;
+            while ((match = triplePattern.exec(whereClause)) !== null) {
+                patterns.push({
+                    subject: match[1],
+                    predicate: match[2],
+                    object: match[3]
+                });
+            }
+        }
+        return { patterns };
+    }
+    /**
+     * 获取解析器格式
+     */
+    getParserFormat(contentType) {
+        if (contentType.includes('turtle'))
+            return 'text/turtle';
+        if (contentType.includes('n-triples'))
+            return 'application/n-triples';
+        if (contentType.includes('n3'))
+            return 'text/n3';
+        if (contentType.includes('rdf+xml'))
+            return 'application/rdf+xml';
+        return 'text/turtle'; // 默认
+    }
+    /**
+     * 解析相对 URI
+     */
+    resolveUri(uri, baseUri) {
+        if (uri.startsWith('http://') || uri.startsWith('https://')) {
+            return uri;
+        }
+        if (uri.startsWith('#')) {
+            return baseUri + uri;
+        }
+        return new URL(uri, baseUri).toString();
+    }
+    /**
+     * 清除缓存
+     */
+    invalidateCache(resourceUrl) {
+        this.cache.delete(resourceUrl);
+    }
+    /**
+     * 清除所有缓存
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * 便捷方法：获取资源的所有三元组
+     */
+    async getResource(resourceUrl) {
+        const store = await this.getResourceStore(resourceUrl);
+        return store.getQuads(null, null, null, null);
+    }
+    /**
+     * 便捷方法：将 Store 序列化为 Turtle
+     */
+    async serializeToTurtle(store) {
+        const writer = new Writer({ format: 'text/turtle' });
+        const quads = store.getQuads(null, null, null, null);
+        return new Promise((resolve, reject) => {
+            writer.addQuads(quads);
+            writer.end((error, result) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve(result);
+            });
+        });
+    }
+}
+//# sourceMappingURL=solid-n3-client.js.map

package/dist/esm/core/solid-n3-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid-n3-client.js","sourceRoot":"","sources":["../../../src/core/solid-n3-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAQ,MAAM,IAAI,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;AAejD,MAAM,OAAO,aAAa;IAIxB,YAAoB,eAAe,KAAK;QAApB,iBAAY,GAAZ,YAAY,CAAQ;QAHhC,UAAK,GAAqD,IAAI,GAAG,EAAE,CAAC;QACpE,iBAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;IAEH,CAAC;IAE5C;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,WAAmB;QAC/C,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAExE,cAAc;QACd,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC5D,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,kBAAkB;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,YAAoB;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,OAAO;YACf,OAAO,EAAE;gBACP,cAAc,EAAE,2BAA2B;aAC5C;YACD,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,SAAS;QACT,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QAChD,OAAO;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,SAAS;QACT,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;YACpD,OAAO,EAAE;gBACP,QAAQ,EAAE,yDAAyD;aACpE;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,eAAe;QACf,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACxB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mBAAmB;YACnB,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO;QACP,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,KAAY,EAAE,OAAe;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAEpC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAS,EAAE,KAAY,EAAE,OAAe;QAChE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QAEzB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAEjE,OAAO;QACP,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CAAC,IAAI,CAChB,OAAO,EACP,SAAS,CAAC,iDAAiD,CAAC,EAC5D,SAAS,CAAC,IAAI,CAAC,CAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,SAAS;QACT,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,OAAO;gBAAE,SAAS;YAE3D,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAE7D,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,IAAI,UAAU,CAAC;gBAEf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAChD,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjB,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;oBACjE,CAAC;yBAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;wBACzC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;oBAC9E,CAAC;yBAAM,CAAC;wBACN,SAAS;oBACX,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtC,CAAC;gBAED,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,KAAY,EAAE,WAAmB;QACzD,sBAAsB;QACtB,0BAA0B;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,QAAQ,GAA6B,EAAE,CAAC;QAE9C,aAAa;QACb,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAC1B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EACnD,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EACvD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EACjH,IAAI,CACL,CAAC;YAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAA2B,EAAE,CAAC;gBAE3C,IAAI,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;gBAChD,CAAC;gBACD,IAAI,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBACpD,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC9C,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,WAAmB,EAAE,eAAuB;QAC5E,kBAAkB;QAClB,qBAAqB;QACrB,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,WAAmB;QAC3C,eAAe;QACf,qBAAqB;QACrB,MAAM,QAAQ,GAAqE,EAAE,CAAC;QAEtF,qBAAqB;QACrB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC7D,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,aAAa,GAAG,6BAA6B,CAAC;YACpD,IAAI,KAAK,CAAC;YAEV,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;oBACnB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,WAAmB;QACzC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,aAAa,CAAC;QACzD,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,uBAAuB,CAAC;QACtE,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAClE,OAAO,aAAa,CAAC,CAAC,KAAK;IAC7B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAW,EAAE,OAAe;QAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,OAAO,GAAG,GAAG,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,WAAmB;QACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,WAAmB;QACnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAY;QAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAErD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC3B,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;oBACpB,OAAO,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/core/sparql/builder/expression-builder.d.ts

@@ -0,0 +1,42 @@
+import { QueryCondition } from '../../query-conditions';
+import { PodTable } from '../../schema';
+import type { UriResolver } from '../../uri';
+import type { TableRegistryContext } from '../../ast-to-sparql';
+export declare class ExpressionBuilder {
+    private tableContext?;
+    private uriResolver;
+    constructor(uriResolver?: UriResolver);
+    /**
+     * Set table context for URI reference resolution
+     */
+    setTableContext(context: TableRegistryContext): void;
+    /**
+     * Convert TableRegistryContext to UriContext
+     */
+    private getUriContext;
+    buildWhereClause(condition: QueryCondition | any, table: PodTable): string;
+    /**
+     * Check if a column is a reference column that needs URI resolution
+     * Delegates to uriResolver for consistency
+     */
+    private isReferenceColumn;
+    /**
+     * Format a value for a reference column, resolving URI if needed
+     * Uses uriResolver for consistent URI resolution
+     */
+    private formatReferenceValue;
+    /**
+     * Format a subject comparison value, resolving UUID/relative IDs to full URIs.
+     */
+    private formatSubjectValue;
+    /**
+     * Check if value is a drizzle-orm SQL object
+     */
+    private isDrizzleSQL;
+    private buildExpression;
+    private buildLogicalExpression;
+    private buildUnaryExpression;
+    private buildBinaryExpression;
+    private resolveColumnName;
+}
+//# sourceMappingURL=expression-builder.d.ts.map

package/dist/esm/core/sparql/builder/expression-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-builder.d.ts","sourceRoot":"","sources":["../../../../../src/core/sparql/builder/expression-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAiB,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAuB;IAC5C,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,GAAE,WAAmC;IAI5D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIpD;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,GAAG,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM;IAK1E;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,qBAAqB;IAuF7B,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/esm/core/sparql/builder/expression-builder.js

@@ -0,0 +1,255 @@
+import { formatValue, getPredicateForColumn } from '../helpers';
+import { UriResolverImpl } from '../../uri';
+export class ExpressionBuilder {
+    constructor(uriResolver = new UriResolverImpl()) {
+        this.uriResolver = uriResolver;
+    }
+    /**
+     * Set table context for URI reference resolution
+     */
+    setTableContext(context) {
+        this.tableContext = context;
+    }
+    /**
+     * Convert TableRegistryContext to UriContext
+     */
+    getUriContext() {
+        if (!this.tableContext)
+            return undefined;
+        return {
+            baseUri: this.tableContext.baseUri,
+            tableRegistry: this.tableContext.tableRegistry,
+            tableNameRegistry: this.tableContext.tableNameRegistry,
+        };
+    }
+    buildWhereClause(condition, table) {
+        const expr = this.buildExpression(condition, table);
+        return expr ? `FILTER(${expr})` : '';
+    }
+    /**
+     * Check if a column is a reference column that needs URI resolution
+     * Delegates to uriResolver for consistency
+     */
+    isReferenceColumn(column) {
+        return this.uriResolver.isReferenceColumn(column);
+    }
+    /**
+     * Format a value for a reference column, resolving URI if needed
+     * Uses uriResolver for consistent URI resolution
+     */
+    formatReferenceValue(value, column, table) {
+        const str = String(value);
+        if (str.startsWith('<') && str.endsWith('>')) {
+            const inner = str.slice(1, -1);
+            if (this.uriResolver.isAbsoluteUri(inner)) {
+                return str;
+            }
+            const context = this.getUriContext();
+            try {
+                const resolved = this.uriResolver.resolveReference(inner, column, context);
+                return `<${resolved}>`;
+            }
+            catch (error) {
+                const tableName = table.config?.name ?? 'unknown';
+                const columnName = column?.name ?? 'unknown';
+                throw new Error(`[ExpressionBuilder] Failed to resolve URI for ${tableName}.${columnName}: ${error}`);
+            }
+        }
+        if (str.startsWith('<'))
+            return str;
+        try {
+            // Pass context as parameter, not internal state
+            const context = this.getUriContext();
+            const resolved = this.uriResolver.resolveReference(str, column, context);
+            return `<${resolved}>`;
+        }
+        catch (e) {
+            const tableName = table.config?.name ?? 'unknown';
+            const columnName = column?.name ?? 'unknown';
+            throw new Error(`[ExpressionBuilder] Failed to resolve URI for ${tableName}.${columnName}: ${e}`);
+        }
+    }
+    /**
+     * Format a subject comparison value, resolving UUID/relative IDs to full URIs.
+     */
+    formatSubjectValue(value, table, isVirtualId) {
+        const raw = String(value ?? '');
+        if (raw.startsWith('<') && raw.endsWith('>')) {
+            const inner = raw.slice(1, -1);
+            if (this.uriResolver.isAbsoluteUri(inner)) {
+                return raw;
+            }
+            const normalizedInner = inner.startsWith('#') ? inner.slice(1) : inner;
+            const uri = this.uriResolver.resolveSubject(table, { id: normalizedInner });
+            return `<${uri}>`;
+        }
+        if (this.uriResolver.isAbsoluteUri(raw))
+            return `<${raw}>`;
+        const normalizedId = raw.startsWith('#') ? raw.slice(1) : raw;
+        const uri = this.uriResolver.resolveSubject(table, { id: normalizedId });
+        return `<${uri}>`;
+    }
+    /**
+     * Check if value is a drizzle-orm SQL object
+     */
+    isDrizzleSQL(value) {
+        if (!value || typeof value !== 'object')
+            return false;
+        // Check for drizzle-orm SQL class signature
+        const entityKind = value.constructor?.[Symbol.for('drizzle:entityKind')];
+        return entityKind === 'SQL' || (Array.isArray(value.queryChunks) && typeof value.getSQL === 'function');
+    }
+    buildExpression(condition, table) {
+        if (!condition || typeof condition !== 'object') {
+            return '';
+        }
+        // Check if this is a drizzle-orm SQL object
+        if (this.isDrizzleSQL(condition)) {
+            throw new Error('Drizzle-ORM operators are not supported. Please use the operators provided by drizzle-solid.');
+        }
+        switch (condition.type) {
+            case 'logical_expr':
+                return this.buildLogicalExpression(condition, table);
+            case 'unary_expr':
+                return this.buildUnaryExpression(condition, table);
+            case 'binary_expr':
+                return this.buildBinaryExpression(condition, table);
+            default:
+                return '';
+        }
+    }
+    buildLogicalExpression(condition, table) {
+        if (!condition.expressions || condition.expressions.length === 0)
+            return '';
+        const parts = condition.expressions
+            .map(c => this.buildExpression(c, table))
+            .filter(s => s.length > 0);
+        if (parts.length === 0)
+            return '';
+        const op = condition.operator === 'OR' ? ' || ' : ' && ';
+        return `(${parts.join(op)})`;
+    }
+    buildUnaryExpression(condition, table) {
+        const op = condition.operator;
+        if (op === 'NOT') {
+            const expr = this.buildExpression(condition.value, table);
+            return `!(${expr})`;
+        }
+        // IS NULL / IS NOT NULL
+        // For UnaryExpression, 'value' holds the target column
+        const colName = this.resolveColumnName(condition.value);
+        if (!colName)
+            return '';
+        // Check if this is a virtual id column (uses @id predicate)
+        const column = table.columns[colName];
+        const isIdColumn = colName === 'id';
+        const idPredicate = isIdColumn && column ? getPredicateForColumn(column, table) : null;
+        const isVirtualId = isIdColumn && idPredicate === '@id';
+        const isSubject = colName === 'subject' || colName === '@id' || isVirtualId;
+        const variable = isSubject ? '?subject' : `?${colName}`;
+        if (op === 'IS NULL') {
+            return `!(BOUND(${variable}))`;
+        }
+        if (op === 'IS NOT NULL') {
+            return `BOUND(${variable})`;
+        }
+        // EXISTS / NOT EXISTS
+        if (op === 'EXISTS' || op === 'NOT EXISTS') {
+            const subquery = String(condition.value);
+            const expr = `EXISTS { ${subquery} }`;
+            return op === 'NOT EXISTS' ? `!(${expr})` : expr;
+        }
+        return '';
+    }
+    buildBinaryExpression(condition, table) {
+        const colName = this.resolveColumnName(condition.left);
+        if (!colName)
+            return '';
+        const column = table.columns[colName];
+        // Determine if id column uses @id predicate (virtual) or real predicate
+        const isIdColumn = colName === 'id';
+        const idPredicate = isIdColumn && column ? getPredicateForColumn(column, table) : null;
+        const isVirtualId = isIdColumn && idPredicate === '@id';
+        // For @id predicate, compare against ?subject; otherwise use column variable
+        const isSubject = colName === 'subject' || colName === '@id' || isVirtualId;
+        const variable = isSubject ? '?subject' : `?${colName}`;
+        // Check if this is a reference column
+        const isReference = this.isReferenceColumn(column);
+        let value = condition.right;
+        // Handle IN / NOT IN
+        if (condition.operator === 'IN' || condition.operator === 'NOT IN') {
+            if (!Array.isArray(value) || value.length === 0)
+                return condition.operator === 'IN' ? 'false' : 'true';
+            const formattedValues = value.map((v) => {
+                if (isSubject) {
+                    return this.formatSubjectValue(v, table, isVirtualId);
+                }
+                if (isReference) {
+                    return this.formatReferenceValue(v, column, table);
+                }
+                return formatValue(v, column, this.uriResolver, this.getUriContext());
+            }).join(', ');
+            const expr = `${variable} IN(${formattedValues})`;
+            return condition.operator === 'NOT IN' ? `!(${expr})` : expr;
+        }
+        // Handle REGEX
+        if (condition.operator === 'REGEX') {
+            const pattern = value.pattern ?? value;
+            const flags = value.flags ?? '';
+            return `REGEX(STR(${variable}), "${pattern}", "${flags}")`;
+        }
+        // Handle LIKE
+        if (condition.operator === 'LIKE') {
+            let pattern = String(value)
+                .replace(/[.+^${}()|[\\]/g, '\\$&')
+                .replace(/%/g, '.*')
+                .replace(/_/g, '.');
+            return `REGEX(STR(${variable}), "^${pattern}$", "i")`;
+        }
+        // Handle ILIKE
+        if (condition.operator === 'ILIKE') {
+            let pattern = String(value)
+                .replace(/[.+^${}()|[\\]/g, '\\$&')
+                .replace(/%/g, '.*')
+                .replace(/_/g, '.');
+            return `REGEX(STR(${variable}), "^${pattern}$", "i")`;
+        }
+        // Handle BETWEEN / NOT BETWEEN
+        if (condition.operator === 'BETWEEN' || condition.operator === 'NOT BETWEEN') {
+            if (!Array.isArray(value) || value.length !== 2)
+                return '';
+            const [min, max] = value;
+            const left = formatValue(min, column, this.uriResolver, this.getUriContext());
+            const right = formatValue(max, column, this.uriResolver, this.getUriContext());
+            const expr = `(${variable} >= ${left} && ${variable} <= ${right})`;
+            return condition.operator === 'NOT BETWEEN' ? `!${expr}` : expr;
+        }
+        // Basic operators (=, !=, <, >, <=, >=)
+        let formattedValue;
+        if (isSubject) {
+            formattedValue = this.formatSubjectValue(value, table, isVirtualId);
+        }
+        else if (isReference) {
+            // Resolve reference URI
+            formattedValue = this.formatReferenceValue(value, column, table);
+        }
+        else {
+            formattedValue = formatValue(value, column, this.uriResolver, this.getUriContext());
+        }
+        return `(${variable} ${condition.operator} ${formattedValue})`;
+    }
+    resolveColumnName(target) {
+        if (typeof target === 'string') {
+            return target.includes('.') ? target.split('.')[1] : target;
+        }
+        if (target && typeof target === 'object' && 'name' in target) {
+            return target.name;
+        }
+        // Handle simple object wrapper { column: 'name' } from old style if any remnants
+        if (target && typeof target === 'object' && 'column' in target) {
+            return target.column;
+        }
+        return '';
+    }
+}
+//# sourceMappingURL=expression-builder.js.map