@undefineds.co/drizzle-solid 0.2.6

package/dist/core/execution/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Execution Module
+ *
+ * Provides execution strategies for different modes (LDP, SPARQL)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LdpExecutor = exports.ExecutionStrategyFactoryImpl = exports.SparqlStrategy = exports.LdpStrategy = void 0;
+// Strategies
+var ldp_strategy_1 = require("./ldp-strategy");
+Object.defineProperty(exports, "LdpStrategy", { enumerable: true, get: function () { return ldp_strategy_1.LdpStrategy; } });
+var sparql_strategy_1 = require("./sparql-strategy");
+Object.defineProperty(exports, "SparqlStrategy", { enumerable: true, get: function () { return sparql_strategy_1.SparqlStrategy; } });
+// Factory
+var strategy_factory_1 = require("./strategy-factory");
+Object.defineProperty(exports, "ExecutionStrategyFactoryImpl", { enumerable: true, get: function () { return strategy_factory_1.ExecutionStrategyFactoryImpl; } });
+// Legacy executor (used internally by LdpStrategy)
+var ldp_executor_1 = require("./ldp-executor");
+Object.defineProperty(exports, "LdpExecutor", { enumerable: true, get: function () { return ldp_executor_1.LdpExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/core/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/execution/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,aAAa;AACb,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAGpB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAGvB,UAAU;AACV,uDAAkE;AAAzD,gIAAA,4BAA4B,OAAA;AAGrC,mDAAmD;AACnD,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}

package/dist/core/execution/ldp-executor.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LDP Executor Implementation
+ *
+ * 负责 LDP 模式下的写操作 (N3 Patch)，剥离自 PodDialect
+ */
+import type { PodTable } from '../schema';
+import type { ComunicaSPARQLExecutor } from '../sparql-executor';
+import type { UriResolver } from '../uri';
+export declare class LdpExecutor {
+    private sparqlExecutor;
+    private fetchFn;
+    private tripleBuilder;
+    private uriResolver;
+    private n3PatchCounter;
+    constructor(sparqlExecutor: ComunicaSPARQLExecutor, fetchFn: typeof fetch, uriResolver: UriResolver);
+    /**
+     * 设置表注册表（用于 URI 引用自动补全）
+     * @param classRegistry rdfClass -> tables[] 的映射
+     * @param nameRegistry tableName -> table 的映射
+     */
+    setTableRegistry(classRegistry: Map<string, PodTable[]>, nameRegistry: Map<string, PodTable>): void;
+    /**
+     * 设置基础 URI
+     */
+    setBaseUri(uri: string): void;
+    /**
+     * 执行 INSERT 操作
+     */
+    executeInsert(rows: any[], table: PodTable, resourceUrl: string): Promise<any[]>;
+    /**
+     * 执行 UPDATE 操作
+     */
+    executeUpdate(table: PodTable, data: Record<string, any>, subjects: string[], resourceUrl: string): Promise<any[]>;
+    /**
+     * 执行 DELETE 操作
+     */
+    executeDelete(subjects: string[], table: PodTable, resourceUrl: string): Promise<any[]>;
+    private resourceExists;
+    private buildUpdatePatchPayload;
+    /**
+     * 执行更新操作
+     *
+     * 优先尝试 SPARQL UPDATE (application/sparql-update)，
+     * xpod 内部使用 SPARQL，标准 CSS 也支持。
+     * 如果失败，回退到 N3 Patch。
+     */
+    private executeN3Patch;
+    /**
+     * 构建 SPARQL UPDATE 查询
+     */
+    private buildSparqlUpdate;
+    /**
+     * 内部 N3 Patch 实现（作为 SPARQL UPDATE 的回退）
+     */
+    private executeN3PatchInternal;
+    /**
+     * 尝试使用 SPARQL UPDATE 进行 Patch
+     * 保留此方法供将来 SPARQL endpoint 增强使用
+     */
+    private trySparqlPatch;
+    private formatTerm;
+    private fetchRecursiveTriplesToDelete;
+    private fetchExistingObjects;
+    private fetchInverseSubjects;
+}
+//# sourceMappingURL=ldp-executor.d.ts.map

package/dist/core/execution/ldp-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ldp-executor.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ldp-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,cAAc,CAAK;gBAEf,cAAc,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW;IAOnG;;;;OAIG;IACH,gBAAgB,CACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAClC,IAAI;IAIP;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IA8IjB;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IA2FjB;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;YAmCH,cAAc;YAWd,uBAAuB;IAqFrC;;;;;;OAMG;YACW,cAAc;IAwE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;YACW,sBAAsB;IA8DpC;;;OAGG;YACW,cAAc;IAa5B,OAAO,CAAC,UAAU;YA2BJ,6BAA6B;YA+C7B,oBAAoB;YAgBpB,oBAAoB;CAUnC"}

package/dist/core/execution/ldp-executor.js

@@ -0,0 +1,584 @@
+"use strict";
+/**
+ * LDP Executor Implementation
+ *
+ * 负责 LDP 模式下的写操作 (N3 Patch)，剥离自 PodDialect
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LdpExecutor = void 0;
+const builder_1 = require("../triple/builder");
+class LdpExecutor {
+    constructor(sparqlExecutor, fetchFn, uriResolver) {
+        // 用于跟踪 N3 Patch 请求数
+        this.n3PatchCounter = 0;
+        this.sparqlExecutor = sparqlExecutor;
+        this.fetchFn = fetchFn;
+        this.uriResolver = uriResolver;
+        this.tripleBuilder = new builder_1.TripleBuilderImpl(uriResolver);
+    }
+    /**
+     * 设置表注册表（用于 URI 引用自动补全）
+     * @param classRegistry rdfClass -> tables[] 的映射
+     * @param nameRegistry tableName -> table 的映射
+     */
+    setTableRegistry(classRegistry, nameRegistry) {
+        this.tripleBuilder.setTableRegistry(classRegistry, nameRegistry);
+    }
+    /**
+     * 设置基础 URI
+     */
+    setBaseUri(uri) {
+        this.tripleBuilder.setBaseUri(uri);
+    }
+    /**
+     * 执行 INSERT 操作
+     */
+    async executeInsert(rows, table, resourceUrl) {
+        const deleteTriples = [];
+        const insertTriples = [];
+        rows.forEach((row, idx) => {
+            // 使用 SubjectResolver 生成 URI
+            const subject = this.uriResolver.resolveSubject(table, row, idx);
+            // 1. rdf:type
+            const typeTriple = this.tripleBuilder.buildTypeTriple(subject, table.config.type);
+            insertTriples.push(...this.tripleBuilder.toN3Strings([typeTriple]));
+            // 2. 处理所有列（跳过纯主键列）
+            Object.entries(table.columns ?? {}).forEach(([key, col]) => {
+                if (row[key] === undefined || row[key] === null)
+                    return;
+                // 跳过纯主键列（predicate 为 @id 的列）
+                // 这类列只用于生成 subject URI，不需要单独的三元组
+                // 但如果主键列有显式的 predicate（如 schema:identifier），则应该写入
+                if (col._virtualId)
+                    return;
+                const predicate = col.options?.predicate || col._predicateUri;
+                if (predicate === '@id')
+                    return;
+                const result = this.tripleBuilder.buildInsert(subject, col, row[key], table);
+                insertTriples.push(...this.tripleBuilder.toN3Strings(result.triples));
+                if (result.childTriples && result.childTriples.length > 0) {
+                    insertTriples.push(...this.tripleBuilder.toN3Strings(result.childTriples));
+                }
+            });
+        });
+        if (insertTriples.length === 0) {
+            return [];
+        }
+        const mode = this.uriResolver.getResourceMode(table);
+        // Document Mode: 每条记录单独写入各自的文件
+        if (mode === 'document') {
+            const results = [];
+            for (let idx = 0; idx < rows.length; idx++) {
+                const row = rows[idx];
+                const subject = this.uriResolver.resolveSubject(table, row, idx);
+                // 从 subject URI 提取资源 URL (去掉 fragment 如果有)
+                const docResourceUrl = this.uriResolver.getResourceUrl(subject);
+                // 收集该记录的三元组
+                const recordTriples = [];
+                const typeTriple = this.tripleBuilder.buildTypeTriple(subject, table.config.type);
+                recordTriples.push(...this.tripleBuilder.toN3Strings([typeTriple]));
+                Object.entries(table.columns ?? {}).forEach(([key, col]) => {
+                    if (row[key] === undefined || row[key] === null)
+                        return;
+                    // 跳过纯主键列（predicate 为 @id 的列）
+                    if (col._virtualId)
+                        return;
+                    const predicate = col.options?.predicate || col._predicateUri;
+                    if (predicate === '@id')
+                        return;
+                    const result = this.tripleBuilder.buildInsert(subject, col, row[key], table);
+                    recordTriples.push(...this.tripleBuilder.toN3Strings(result.triples));
+                    if (result.childTriples && result.childTriples.length > 0) {
+                        recordTriples.push(...this.tripleBuilder.toN3Strings(result.childTriples));
+                    }
+                });
+                if (recordTriples.length === 0)
+                    continue;
+                const body = recordTriples.join('\n');
+                const response = await this.fetchFn(docResourceUrl, {
+                    method: 'PUT',
+                    headers: { 'Content-Type': 'text/turtle' },
+                    body
+                });
+                if (![200, 201, 202, 204, 205].includes(response.status)) {
+                    const text = await response.text().catch(() => '');
+                    throw new Error(`PUT failed for ${docResourceUrl}: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+                }
+                await this.sparqlExecutor.invalidateHttpCache(docResourceUrl);
+                const lastSlash = docResourceUrl.lastIndexOf('/');
+                if (lastSlash > 0) {
+                    const containerUrl = docResourceUrl.slice(0, lastSlash + 1);
+                    await this.sparqlExecutor.invalidateHttpCache(containerUrl);
+                }
+                results.push({ success: true, source: docResourceUrl, status: response.status, via: 'put' });
+            }
+            return results;
+        }
+        // Fragment Mode: 所有记录写入同一个文件
+        // 使用 SPARQL UPDATE (INSERT DATA) 进行插入
+        const sparql = `INSERT DATA {\n${insertTriples.join('\n')}\n}`;
+        let response = await this.fetchFn(resourceUrl, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/sparql-update' },
+            body: sparql
+        });
+        // 如果返回 201（创建）但实际可能没创建资源，验证一下
+        // 如果资源不存在 (404) 或创建后仍不可访问，先 PUT 创建再重试
+        if (response.status === 404 || response.status === 201) {
+            // 验证资源是否真的存在
+            const checkRes = await this.fetchFn(resourceUrl, { method: 'HEAD' });
+            if (!checkRes.ok && checkRes.status !== 405) {
+                // 资源不存在，先创建
+                const createRes = await this.fetchFn(resourceUrl, {
+                    method: 'PUT',
+                    headers: { 'Content-Type': 'text/turtle' },
+                    body: ''
+                });
+                if (createRes.ok || createRes.status === 409 || createRes.status === 201) {
+                    // 重试 SPARQL UPDATE
+                    response = await this.fetchFn(resourceUrl, {
+                        method: 'PATCH',
+                        headers: { 'Content-Type': 'application/sparql-update' },
+                        body: sparql
+                    });
+                }
+            }
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            const err = new Error(`SPARQL UPDATE INSERT failed: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+            err.status = response.status;
+            throw err;
+        }
+        // 清理缓存：资源本身和容器
+        await this.sparqlExecutor.invalidateHttpCache(resourceUrl);
+        const lastSlash = resourceUrl.lastIndexOf('/');
+        if (lastSlash > 0) {
+            const containerUrl = resourceUrl.slice(0, lastSlash + 1);
+            await this.sparqlExecutor.invalidateHttpCache(containerUrl);
+        }
+        return [{ success: true, source: resourceUrl, status: response.status, via: 'sparql-update' }];
+    }
+    /**
+     * 执行 UPDATE 操作
+     */
+    async executeUpdate(table, data, subjects, resourceUrl) {
+        if (!subjects.length) {
+            return [];
+        }
+        const results = [];
+        const mode = this.uriResolver.getResourceMode(table);
+        for (const subject of subjects) {
+            // Document mode: 从 subject URI 获取资源 URL
+            const targetResourceUrl = mode === 'document'
+                ? this.uriResolver.getResourceUrl(subject)
+                : resourceUrl;
+            // 1. 获取普通字段的 Patch 数据（无 WHERE 子句）
+            const patchData = await this.buildUpdatePatchPayload(subject, table, data, targetResourceUrl);
+            if (!patchData)
+                continue;
+            const { deleteTriples, insertTriples, deleteWherePatterns } = patchData;
+            // 2. 处理内联对象字段（TripleBuilder 的 buildDelete 和 buildInsert 已经处理了逻辑）
+            // 但我们需要先查询旧的内联对象以便删除
+            // 这里需要特殊的逻辑来处理"更新"语义：先删旧的，再插新的
+            // 额外的内联对象清理逻辑
+            const entries = Object.entries(data).filter(([_, value]) => value !== undefined);
+            for (const [key, rawValue] of entries) {
+                // 跳过系统字段
+                if (key === '@id' || key === 'subject')
+                    continue;
+                const col = table.columns?.[key];
+                if (!col)
+                    continue;
+                // 跳过虚拟 ID 列
+                if (col._virtualId || col.options?.predicate === '@id')
+                    continue;
+                // 检查是否是内联对象列
+                const isInline = col.dataType === 'object' || col.dataType === 'json' ||
+                    (col.dataType === 'array' && (col.elementType === 'object' || col.options?.baseType === 'object'));
+                if (!isInline)
+                    continue;
+                const predicate = this.tripleBuilder.getPredicateUri(col, table);
+                // A. 查找旧的内联对象
+                // 使用 SPARQL 查询找到旧的链接
+                const childUris = await this.fetchExistingObjects(targetResourceUrl, subject, predicate);
+                for (const childUriRaw of childUris) {
+                    let childUri = childUriRaw;
+                    if (!childUri.startsWith('<') && !childUri.startsWith('_:')) {
+                        childUri = `<${childUri}>`;
+                    }
+                    // 删除链接: <subject> <predicate> <childUri> .
+                    deleteTriples.push(`<${subject}> <${predicate}> ${childUri} .`);
+                    // 删除子对象的所有三元组 (递归)
+                    if (childUri.startsWith('<')) {
+                        const cleanUri = childUri.slice(1, -1);
+                        const childTriples = await this.fetchRecursiveTriplesToDelete(cleanUri, table, targetResourceUrl);
+                        deleteTriples.push(...childTriples);
+                    }
+                }
+                // B. 插入逻辑由 buildInsert 处理，已经包含在 patchData.insertTriples 中
+            }
+            // 去重和冲突检查
+            const uniqueDeletes = Array.from(new Set(deleteTriples));
+            const uniqueInserts = Array.from(new Set(insertTriples));
+            // CSS N3 Patch forbids deleting and inserting the same triple in one patch
+            const finalDeletes = uniqueDeletes.filter(t => !uniqueInserts.includes(t));
+            const finalInserts = uniqueInserts.filter(t => !uniqueDeletes.includes(t));
+            if (finalDeletes.length === 0 && finalInserts.length === 0) {
+                continue;
+            }
+            const res = await this.executeN3Patch(targetResourceUrl, finalDeletes, finalInserts, [], deleteWherePatterns);
+            results.push(...res);
+            // Delay between updates to prevent server overload/locking
+            await new Promise(r => setTimeout(r, 200));
+        }
+        return results;
+    }
+    /**
+     * 执行 DELETE 操作
+     */
+    async executeDelete(subjects, table, resourceUrl) {
+        const results = [];
+        const mode = this.uriResolver.getResourceMode(table);
+        for (const subject of subjects) {
+            try {
+                // Document mode: 从 subject URI 获取资源 URL
+                const targetResourceUrl = mode === 'document'
+                    ? this.uriResolver.getResourceUrl(subject)
+                    : resourceUrl;
+                // Recursively fetch all triples for this subject and its inline children
+                const deleteTriples = await this.fetchRecursiveTriplesToDelete(subject, table, targetResourceUrl);
+                const uniqueDeletes = Array.from(new Set(deleteTriples));
+                if (uniqueDeletes.length > 0) {
+                    const patchRes = await this.executeN3Patch(targetResourceUrl, uniqueDeletes, [], [] // Empty WHERE since we delete explicit triples
+                    );
+                    results.push(...patchRes);
+                }
+            }
+            catch (error) {
+                console.error(`[DELETE] Failed to delete subject ${subject}:`, error);
+                throw error;
+            }
+        }
+        return results;
+    }
+    // ================= Private Helpers =================
+    async resourceExists(resourceUrl) {
+        try {
+            const response = await this.fetchFn(resourceUrl, { method: 'HEAD' });
+            if (response.ok || response.status === 405)
+                return true;
+            if (response.status === 404)
+                return false;
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async buildUpdatePatchPayload(subject, table, data, resourceUrl) {
+        const deleteTriples = [];
+        const insertTriples = [];
+        const deleteWherePatterns = [];
+        for (const [key, rawValue] of Object.entries(data)) {
+            if (rawValue === undefined)
+                continue;
+            // 跳过 @id 和 subject 等系统字段（不允许修改主键）
+            if (key === '@id' || key === 'subject')
+                continue;
+            const col = table.columns?.[key];
+            if (!col)
+                continue;
+            // 跳过虚拟 ID 列（predicate 是 @id，不是有效的 RDF URI）
+            if (col._virtualId || col.options?.predicate === '@id')
+                continue;
+            // 内联对象特殊处理在 executeUpdate 主循环中做
+            const isInline = col.dataType === 'object' || col.dataType === 'json' ||
+                (col.dataType === 'array' && (col.elementType === 'object' || col.options?.baseType === 'object'));
+            if (isInline) {
+                // 只处理插入部分，删除部分由主循环处理
+                if (rawValue !== null) {
+                    const result = this.tripleBuilder.buildInsert(subject, col, rawValue, table);
+                    insertTriples.push(...this.tripleBuilder.toN3Strings(result.triples));
+                    if (result.childTriples) {
+                        insertTriples.push(...this.tripleBuilder.toN3Strings(result.childTriples));
+                    }
+                }
+                continue;
+            }
+            const predicate = this.tripleBuilder.getPredicateUri(col, table);
+            const isInverse = Boolean(col.options?.inverse);
+            const safeKey = key.replace(/[^a-zA-Z0-9_]/g, '_');
+            if (isInverse) {
+                // Delete all inverse links for this predicate to avoid stale values.
+                deleteWherePatterns.push(`?s_${safeKey} <${predicate}> <${subject}> .`);
+                // Inverse logic
+                const existingSubjects = await this.fetchInverseSubjects(resourceUrl, subject, predicate);
+                existingSubjects.forEach(s => {
+                    let sUri = s;
+                    if (!sUri.startsWith('<') && !sUri.startsWith('_:'))
+                        sUri = `<${sUri}>`;
+                    deleteTriples.push(`${sUri} <${predicate}> <${subject}> .`);
+                });
+                if (rawValue !== null) {
+                    // 使用 TripleBuilder 构建插入
+                    const result = this.tripleBuilder.buildInsert(subject, col, rawValue, table);
+                    insertTriples.push(...this.tripleBuilder.toN3Strings(result.triples));
+                }
+                continue;
+            }
+            // Normal logic
+            // fetch existing values to build concrete delete triples
+            // Delete all existing predicate values to avoid stale literals (e.g. updatedAt duplication).
+            deleteWherePatterns.push(`<${subject}> <${predicate}> ?o_${safeKey} .`);
+            const existingValues = await this.fetchExistingObjects(resourceUrl, subject, predicate);
+            existingValues.forEach((existing) => {
+                // existing is already formatted N3 term from formatTerm
+                deleteTriples.push(`<${subject}> <${predicate}> ${existing} .`);
+            });
+            if (rawValue === null) {
+                continue;
+            }
+            const result = this.tripleBuilder.buildInsert(subject, col, rawValue, table);
+            insertTriples.push(...this.tripleBuilder.toN3Strings(result.triples));
+        }
+        return { deleteTriples, insertTriples, deleteWherePatterns };
+    }
+    /**
+     * 执行更新操作
+     *
+     * 优先尝试 SPARQL UPDATE (application/sparql-update)，
+     * xpod 内部使用 SPARQL，标准 CSS 也支持。
+     * 如果失败，回退到 N3 Patch。
+     */
+    async executeN3Patch(resourceUrl, deleteTriples, insertTriples, wherePatterns = [], deleteWherePatterns = []) {
+        if (deleteTriples.length === 0 && insertTriples.length === 0 && deleteWherePatterns.length === 0) {
+            return [];
+        }
+        this.n3PatchCounter++;
+        // 构建 SPARQL UPDATE 查询
+        const sparqlUpdate = this.buildSparqlUpdate(deleteTriples, insertTriples, deleteWherePatterns);
+        let response;
+        let lastError;
+        // 首先尝试 SPARQL UPDATE
+        for (let i = 0; i < 3; i++) {
+            try {
+                response = await this.fetchFn(resourceUrl, {
+                    method: 'PATCH',
+                    headers: {
+                        'Content-Type': 'application/sparql-update'
+                    },
+                    body: sparqlUpdate
+                });
+                if (response.ok) {
+                    await this.sparqlExecutor.invalidateHttpCache(resourceUrl);
+                    return [{ success: true, source: resourceUrl, status: response.status, via: 'sparql-update' }];
+                }
+                // 如果 SPARQL UPDATE 不被支持 (415/405)，尝试 N3 Patch
+                // 如果 SPARQL UPDATE 不被支持 (415/405)，尝试 N3 Patch
+                if (response.status === 415 || response.status === 405) {
+                    const fallbackDeletes = deleteWherePatterns.length > 0
+                        ? [...deleteTriples, ...deleteWherePatterns]
+                        : deleteTriples;
+                    const fallbackWhere = deleteWherePatterns.length > 0
+                        ? deleteWherePatterns
+                        : wherePatterns;
+                    return await this.executeN3PatchInternal(resourceUrl, fallbackDeletes, insertTriples, fallbackWhere);
+                }
+                // 服务器错误，重试
+                if (response.status >= 500 || response.status === 409) {
+                    await new Promise(r => setTimeout(r, 1000 * (i + 1)));
+                    continue;
+                }
+                break;
+            }
+            catch (e) {
+                lastError = e;
+                if (i < 2)
+                    await new Promise(r => setTimeout(r, 1000 * (i + 1)));
+            }
+        }
+        if (!response || !response.ok) {
+            const text = response ? await response.text().catch(() => '') : '';
+            const status = response ? response.status : 'Network Error';
+            const statusText = response ? response.statusText : (lastError instanceof Error ? lastError.message : String(lastError));
+            const error = new Error(`SPARQL UPDATE failed: ${status} ${statusText}${text ? ` - ${text}` : ''}`);
+            error.status = status;
+            throw error;
+        }
+        await this.sparqlExecutor.invalidateHttpCache(resourceUrl);
+        return [{ success: true, source: resourceUrl, status: response.status, via: 'sparql-update' }];
+    }
+    /**
+     * 构建 SPARQL UPDATE 查询
+     */
+    buildSparqlUpdate(deleteTriples, insertTriples, deleteWherePatterns) {
+        const parts = [];
+        if (deleteWherePatterns.length > 0) {
+            for (const pattern of deleteWherePatterns) {
+                parts.push(`DELETE WHERE {\n${pattern}\n}`);
+            }
+        }
+        if (deleteTriples.length > 0) {
+            parts.push(`DELETE DATA {\n${deleteTriples.join('\n')}\n}`);
+        }
+        if (insertTriples.length > 0) {
+            parts.push(`INSERT DATA {\n${insertTriples.join('\n')}\n}`);
+        }
+        // 如果同时有删除和插入，用分号连接（CSS 支持多条语句）
+        return parts.join(';\n');
+    }
+    /**
+     * 内部 N3 Patch 实现（作为 SPARQL UPDATE 的回退）
+     */
+    async executeN3PatchInternal(resourceUrl, deleteTriples, insertTriples, wherePatterns = []) {
+        const patch = this.tripleBuilder.buildN3Patch(deleteTriples, insertTriples, wherePatterns);
+        let response;
+        let lastError;
+        for (let i = 0; i < 3; i++) {
+            try {
+                response = await this.fetchFn(resourceUrl, {
+                    method: 'PATCH',
+                    headers: {
+                        'Content-Type': 'text/n3'
+                    },
+                    body: patch
+                });
+                if (response.status === 404) {
+                    const createRes = await this.fetchFn(resourceUrl, {
+                        method: 'PUT',
+                        headers: { 'Content-Type': 'text/turtle' },
+                        body: ''
+                    });
+                    if (!createRes.ok && createRes.status !== 409) {
+                        throw new Error(`Failed to create resource ${resourceUrl}: ${createRes.status} ${createRes.statusText}`);
+                    }
+                    response = await this.fetchFn(resourceUrl, {
+                        method: 'PATCH',
+                        headers: { 'Content-Type': 'text/n3' },
+                        body: patch
+                    });
+                }
+                if (response.ok)
+                    break;
+                if (response.status >= 500 || response.status === 409) {
+                    await new Promise(r => setTimeout(r, 1000 * (i + 1)));
+                    continue;
+                }
+                break;
+            }
+            catch (e) {
+                lastError = e;
+                if (i < 2)
+                    await new Promise(r => setTimeout(r, 1000 * (i + 1)));
+            }
+        }
+        if (!response || !response.ok) {
+            const text = response ? await response.text().catch(() => '') : '';
+            const status = response ? response.status : 'Network Error';
+            const statusText = response ? response.statusText : (lastError instanceof Error ? lastError.message : String(lastError));
+            const error = new Error(`N3 PATCH failed: ${status} ${statusText}${text ? ` - ${text}` : ''}`);
+            error.status = status;
+            throw error;
+        }
+        await this.sparqlExecutor.invalidateHttpCache(resourceUrl);
+        return [{ success: true, source: resourceUrl, status: response.status, via: 'n3' }];
+    }
+    /**
+     * 尝试使用 SPARQL UPDATE 进行 Patch
+     * 保留此方法供将来 SPARQL endpoint 增强使用
+     */
+    async trySparqlPatch(resourceUrl, sparql) {
+        try {
+            const response = await this.fetchFn(resourceUrl, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/sparql-update' },
+                body: sparql
+            });
+            return response.ok;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    formatTerm(term) {
+        if (!term)
+            return '';
+        if (term.termType === 'NamedNode')
+            return `<${term.value}>`;
+        if (term.termType === 'BlankNode')
+            return `_:${term.value}`;
+        if (term.termType === 'Literal') {
+            // Robust escaping for N-Triples/Turtle
+            const escaped = String(term.value ?? '')
+                .replace(/\\/g, '\\\\')
+                .replace(/"/g, '\\"')
+                .replace(/\n/g, '\\n')
+                .replace(/\r/g, '\\r');
+            const quoted = `"${escaped}"`;
+            if (term.language)
+                return `${quoted}@${term.language}`;
+            if (term.datatype && term.datatype.value) {
+                if (term.datatype.value === 'http://www.w3.org/2001/XMLSchema#integer' || term.datatype.value.endsWith('#integer')) {
+                    return term.value;
+                }
+                if (term.datatype.value !== 'http://www.w3.org/2001/XMLSchema#string') {
+                    return `${quoted}^^<${term.datatype.value}>`;
+                }
+            }
+            return quoted;
+        }
+        return String(term.value ?? term);
+    }
+    async fetchRecursiveTriplesToDelete(subject, table, resourceUrl, visited = new Set()) {
+        if (visited.has(subject))
+            return [];
+        visited.add(subject);
+        const query = `SELECT ?p ?o WHERE { <${subject}> ?p ?o . }`;
+        const bindings = await this.sparqlExecutor.queryBindings(query, resourceUrl);
+        const triples = [];
+        const childSubjects = [];
+        bindings.forEach((binding) => {
+            const p = binding.get('p');
+            const o = binding.get('o');
+            if (!p || !o)
+                return;
+            triples.push(`<${subject}> ${this.formatTerm(p)} ${this.formatTerm(o)} .`);
+            if (o.termType === 'NamedNode') {
+                // Check against table schema to see if this is an inline column
+                const pVal = p.value;
+                for (const [colName, col] of Object.entries(table.columns)) {
+                    const predicate = this.tripleBuilder.getPredicateUri(col, table);
+                    // Check if column is inline
+                    const isInline = col.dataType === 'object' || col.dataType === 'json' ||
+                        (col.dataType === 'array' && (col.elementType === 'object' || col.options?.baseType === 'object'));
+                    if (predicate === pVal && isInline) {
+                        childSubjects.push(o.value);
+                    }
+                }
+            }
+        });
+        for (const childSubject of childSubjects) {
+            const childTriples = await this.fetchRecursiveTriplesToDelete(childSubject, table, resourceUrl, visited);
+            triples.push(...childTriples);
+        }
+        return triples;
+    }
+    async fetchExistingObjects(resourceUrl, subject, predicate) {
+        const query = `SELECT ?o WHERE { <${subject}> <${predicate}> ?o . }`;
+        const bindings = await this.sparqlExecutor.queryBindings(query, resourceUrl);
+        return bindings
+            .map((binding) => {
+            const o = binding.get('o');
+            return this.formatTerm(o);
+        })
+            .filter((val) => !!val);
+    }
+    async fetchInverseSubjects(resourceUrl, object, predicate) {
+        const query = `SELECT ?s WHERE { ?s <${predicate}> <${object}> . }`;
+        const rows = await this.sparqlExecutor.queryContainer(resourceUrl, { type: 'SELECT', query });
+        return rows.map((row) => row.s ?? row['?s']).filter(Boolean);
+    }
+}
+exports.LdpExecutor = LdpExecutor;
+//# sourceMappingURL=ldp-executor.js.map