@undefineds.co/xpod 0.3.6 → 0.3.15

package/dist/solidfs/types.d.ts

@@ -0,0 +1,131 @@
+export type SolidFsProjection = 'direct' | 'copy' | 'hydrated-object';
+export type SolidFsEntrySource = 'filesystem' | 'pod-http' | 'object';
+export type SolidFsEntryState = 'clean' | 'dirty' | 'committed' | 'conflict';
+export type SolidFsChangeType = 'created' | 'updated' | 'deleted';
+export interface SolidFsRunRef {
+    id?: string;
+    workspace?: string;
+}
+export interface SolidFsPrepareInput {
+    run?: SolidFsRunRef;
+    workspace: string;
+    /**
+     * Adapter-provided local source path for workspaces that are resolved by
+     * the runner before SolidFS materializes them, such as Pod HTTPS containers.
+     */
+    sourcePath?: string;
+    projection?: SolidFsProjection;
+    /**
+     * Opaque request/runtime context used by adapter syncers. SolidFS itself must
+     * not inspect or persist this value because it can contain credentials.
+     */
+    context?: unknown;
+}
+export interface SolidFsManifestEntry {
+    path: string;
+    resource?: string;
+    source: SolidFsEntrySource;
+    sourcePath: string;
+    contentType?: string;
+    projection: SolidFsProjection;
+    /**
+     * Opaque authority-side version token, such as an ETag, object version, RDF
+     * revision, or filesystem hash. For local filesystem projections this can be
+     * the same value used for dirty detection.
+     */
+    sourceVersion?: string;
+    /**
+     * Local working-copy version captured when the entry was materialized. This
+     * lets hydrated objects keep an authority ETag in sourceVersion while still
+     * detecting local edits by hashing the working file.
+     */
+    workingVersion?: string;
+    lastAccessedAt?: number;
+    state: SolidFsEntryState;
+}
+export interface SolidFsChange {
+    path: string;
+    resource?: string;
+    source: SolidFsEntrySource;
+    sourcePath: string;
+    contentType?: string;
+    projection: SolidFsProjection;
+    type: SolidFsChangeType;
+    sourceVersion?: string;
+}
+export interface SolidFsManifest {
+    workspace: string;
+    cwd: string;
+    projection: SolidFsProjection;
+    entries: SolidFsManifestEntry[];
+    changes?: SolidFsChange[];
+}
+export interface SolidFsConflict {
+    path: string;
+    sourcePath: string;
+    expectedVersion?: string;
+    actualVersion?: string;
+    message: string;
+}
+export declare class SolidFsConflictError extends Error {
+    readonly conflicts: SolidFsConflict[];
+    constructor(conflicts: SolidFsConflict[]);
+}
+export declare class SolidFsNotFoundError extends Error {
+    constructor(message: string);
+}
+export interface MaterializedWorkspace {
+    cwd: string;
+    manifest: SolidFsManifest;
+    /**
+     * Materialize one object-backed resource into the real cwd. Implementations
+     * without object hydration support can leave this undefined.
+     */
+    hydrate?(relativePath: string): Promise<SolidFsManifestEntry>;
+    /**
+     * Remove clean hydrated working copies that are no longer needed. Dirty files
+     * must never be pruned.
+     */
+    prune?(options?: SolidFsPruneOptions): Promise<SolidFsManifest>;
+    commit(): Promise<SolidFsManifest>;
+    rollback(): Promise<void>;
+}
+export interface SolidFS {
+    prepare(input: SolidFsPrepareInput): Promise<MaterializedWorkspace>;
+}
+export interface SolidFsSyncer {
+    shouldTrack?(input: SolidFsPrepareInput): boolean;
+    shouldTrackPath?(relativePath: string): boolean;
+    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;
+}
+export interface SolidFsHydrateInput {
+    path: string;
+    targetPath: string;
+    workspace: SolidFsManifest;
+    context?: unknown;
+}
+export interface SolidFsHydrateResult {
+    contentType?: string;
+    sourceVersion?: string;
+}
+export interface SolidFsCommitHydratedInput {
+    change: SolidFsChange;
+    workspace: SolidFsManifest;
+    context?: unknown;
+}
+export interface SolidFsCommitHydratedResult {
+    sourceVersion?: string;
+}
+export interface SolidFsHydrator {
+    hydrate(input: SolidFsHydrateInput): Promise<SolidFsHydrateResult | void>;
+    commit(input: SolidFsCommitHydratedInput): Promise<SolidFsCommitHydratedResult | void>;
+    delete?(input: SolidFsCommitHydratedInput): Promise<void>;
+}
+export interface SolidFsPruneOptions {
+    /**
+     * Prune clean hydrated files not accessed for at least this many ms.
+     * Defaults to 0, meaning any clean hydrated file is eligible.
+     */
+    olderThanMs?: number;
+    now?: number;
+}

package/dist/solidfs/types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolidFsNotFoundError = exports.SolidFsConflictError = void 0;
+class SolidFsConflictError extends Error {
+    constructor(conflicts) {
+        super(`SolidFS commit conflict: ${conflicts.map((conflict) => conflict.path).join(', ')}`);
+        this.name = 'SolidFsConflictError';
+        this.conflicts = conflicts;
+    }
+}
+exports.SolidFsConflictError = SolidFsConflictError;
+class SolidFsNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SolidFsNotFoundError';
+    }
+}
+exports.SolidFsNotFoundError = SolidFsNotFoundError;
+//# sourceMappingURL=types.js.map

package/dist/solidfs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/solidfs/types.ts"],"names":[],"mappings":";;;AA6EA,MAAa,oBAAqB,SAAQ,KAAK;IAG7C,YAAmB,SAA4B;QAC7C,KAAK,CAAC,4BAA4B,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AARD,oDAQC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC","sourcesContent":["export type SolidFsProjection = 'direct' | 'copy' | 'hydrated-object';\nexport type SolidFsEntrySource = 'filesystem' | 'pod-http' | 'object';\n\nexport type SolidFsEntryState = 'clean' | 'dirty' | 'committed' | 'conflict';\nexport type SolidFsChangeType = 'created' | 'updated' | 'deleted';\n\nexport interface SolidFsRunRef {\n  id?: string;\n  workspace?: string;\n}\n\nexport interface SolidFsPrepareInput {\n  run?: SolidFsRunRef;\n  workspace: string;\n  /**\n   * Adapter-provided local source path for workspaces that are resolved by\n   * the runner before SolidFS materializes them, such as Pod HTTPS containers.\n   */\n  sourcePath?: string;\n  projection?: SolidFsProjection;\n  /**\n   * Opaque request/runtime context used by adapter syncers. SolidFS itself must\n   * not inspect or persist this value because it can contain credentials.\n   */\n  context?: unknown;\n}\n\nexport interface SolidFsManifestEntry {\n  path: string;\n  resource?: string;\n  source: SolidFsEntrySource;\n  sourcePath: string;\n  contentType?: string;\n  projection: SolidFsProjection;\n  /**\n   * Opaque authority-side version token, such as an ETag, object version, RDF\n   * revision, or filesystem hash. For local filesystem projections this can be\n   * the same value used for dirty detection.\n   */\n  sourceVersion?: string;\n  /**\n   * Local working-copy version captured when the entry was materialized. This\n   * lets hydrated objects keep an authority ETag in sourceVersion while still\n   * detecting local edits by hashing the working file.\n   */\n  workingVersion?: string;\n  lastAccessedAt?: number;\n  state: SolidFsEntryState;\n}\n\nexport interface SolidFsChange {\n  path: string;\n  resource?: string;\n  source: SolidFsEntrySource;\n  sourcePath: string;\n  contentType?: string;\n  projection: SolidFsProjection;\n  type: SolidFsChangeType;\n  sourceVersion?: string;\n}\n\nexport interface SolidFsManifest {\n  workspace: string;\n  cwd: string;\n  projection: SolidFsProjection;\n  entries: SolidFsManifestEntry[];\n  changes?: SolidFsChange[];\n}\n\nexport interface SolidFsConflict {\n  path: string;\n  sourcePath: string;\n  expectedVersion?: string;\n  actualVersion?: string;\n  message: string;\n}\n\nexport class SolidFsConflictError extends Error {\n  public readonly conflicts: SolidFsConflict[];\n\n  public constructor(conflicts: SolidFsConflict[]) {\n    super(`SolidFS commit conflict: ${conflicts.map((conflict) => conflict.path).join(', ')}`);\n    this.name = 'SolidFsConflictError';\n    this.conflicts = conflicts;\n  }\n}\n\nexport class SolidFsNotFoundError extends Error {\n  public constructor(message: string) {\n    super(message);\n    this.name = 'SolidFsNotFoundError';\n  }\n}\n\nexport interface MaterializedWorkspace {\n  cwd: string;\n  manifest: SolidFsManifest;\n  /**\n   * Materialize one object-backed resource into the real cwd. Implementations\n   * without object hydration support can leave this undefined.\n   */\n  hydrate?(relativePath: string): Promise<SolidFsManifestEntry>;\n  /**\n   * Remove clean hydrated working copies that are no longer needed. Dirty files\n   * must never be pruned.\n   */\n  prune?(options?: SolidFsPruneOptions): Promise<SolidFsManifest>;\n  commit(): Promise<SolidFsManifest>;\n  rollback(): Promise<void>;\n}\n\nexport interface SolidFS {\n  prepare(input: SolidFsPrepareInput): Promise<MaterializedWorkspace>;\n}\n\nexport interface SolidFsSyncer {\n  shouldTrack?(input: SolidFsPrepareInput): boolean;\n  shouldTrackPath?(relativePath: string): boolean;\n  sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;\n}\n\nexport interface SolidFsHydrateInput {\n  path: string;\n  targetPath: string;\n  workspace: SolidFsManifest;\n  context?: unknown;\n}\n\nexport interface SolidFsHydrateResult {\n  contentType?: string;\n  sourceVersion?: string;\n}\n\nexport interface SolidFsCommitHydratedInput {\n  change: SolidFsChange;\n  workspace: SolidFsManifest;\n  context?: unknown;\n}\n\nexport interface SolidFsCommitHydratedResult {\n  sourceVersion?: string;\n}\n\nexport interface SolidFsHydrator {\n  hydrate(input: SolidFsHydrateInput): Promise<SolidFsHydrateResult | void>;\n  commit(input: SolidFsCommitHydratedInput): Promise<SolidFsCommitHydratedResult | void>;\n  delete?(input: SolidFsCommitHydratedInput): Promise<void>;\n}\n\nexport interface SolidFsPruneOptions {\n  /**\n   * Prune clean hydrated files not accessed for at least this many ms.\n   * Defaults to 0, meaning any clean hydrated file is eligible.\n   */\n  olderThanMs?: number;\n  now?: number;\n}\n"]}

package/dist/storage/RepresentationPartialConvertingStore.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RepresentationPartialConvertingStore = void 0;
 const global_logger_factory_1 = require("global-logger-factory");
 const community_server_1 = require("@solid/community-server");
+const RdfContentTypes_1 = require("./rdf/RdfContentTypes");
 /**
  * A store that converts representations based on their content type.
  */
@@ -26,19 +27,11 @@ class RepresentationPartialConvertingStore extends community_server_1.Passthroug
         }
         const contentType = representation.metadata.contentType;
         const preferencesType = Object.keys(preferences.type || {})[0];
-        // Whitelist: Only allow conversion for known, pure RDF formats.
-        // Everything else (HTML, Markdown, Images, random XML/JSON) is treated as a file.
-        const SAFE_RDF_TYPES = new Set([
-            'text/turtle',
-            'application/ld+json',
-            'application/n-triples',
-            'application/n-quads',
-            'application/trig',
-            'text/n3',
-            'application/rdf+xml',
-            community_server_1.INTERNAL_QUADS // Necessary for GET requests to convert internal quads back to public formats
-        ]);
-        if (!SAFE_RDF_TYPES.has(contentType)) {
+        if (preferences.type?.[contentType]) {
+            this.logger.debug(`Not converting ${identifier.path}: ${contentType} already satisfies preferences`);
+            return false;
+        }
+        if (contentType !== community_server_1.INTERNAL_QUADS && !(0, RdfContentTypes_1.isSafeRdfDocumentContentType)(contentType)) {
             this.logger.debug(`Not converting ${identifier.path}: ${contentType} is not in RDF whitelist`);
             return false;
         }

package/dist/storage/RepresentationPartialConvertingStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"RepresentationPartialConvertingStore.js","sourceRoot":"","sources":["../../src/storage/RepresentationPartialConvertingStore.ts"],"names":[],"mappings":"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","sourcesContent":["import rdfParser from 'rdf-parse';\nimport { getLoggerFor } from 'global-logger-factory';\n\nimport {\n  PassthroughStore,\n  PassthroughConverter,\n  AuxiliaryStrategy,\n  ResourceStore,\n  RepresentationConverter,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Representation,\n  RepresentationConverterArgs,\n  Conditions,\n  \n  ChangeMap,\n  INTERNAL_QUADS,\n  APPLICATION_JSON,\n} from \"@solid/community-server\"\n\ninterface RepresentationPartialConvertingStoreOptions {\n  outConverter?: RepresentationConverter\n  inConverter?: RepresentationConverter\n  inPreferences?: RepresentationPreferences\n}\n\n/**\n * A store that converts representations based on their content type.\n */\nexport class RepresentationPartialConvertingStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  protected readonly logger = getLoggerFor(this)\n\n  private readonly metadataStrategy: AuxiliaryStrategy\n  private readonly inConverter: RepresentationConverter\n  private readonly outConverter: RepresentationConverter\n  private readonly inPreferences: RepresentationPreferences\n  \n  constructor(\n    source: T,\n    metadataStrategy: AuxiliaryStrategy,\n    options: RepresentationPartialConvertingStoreOptions,\n  ) {\n    super(source)\n    this.metadataStrategy = metadataStrategy\n    this.inConverter = options.inConverter ?? new PassthroughConverter();\n    this.outConverter = options.outConverter ?? new PassthroughConverter();\n    this.inPreferences = options.inPreferences ?? {};\n\n    const inConverterClass = this.inConverter.constructor.name;\n    const outConverterClass = this.outConverter.constructor.name;\n    this.logger.debug(\n      `Initializing with inConverter: ${inConverterClass}, \n      outConverter: ${outConverterClass}, \n      inPreferences: ${JSON.stringify(this.inPreferences)}`);\n  }\n\n  private async shouldConvert(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    preferences: RepresentationPreferences,\n  ) {\n    if (representation.metadata.contentType === undefined) {\n      return false\n    }\n\n    const contentType = representation.metadata.contentType;\n    const preferencesType = Object.keys(preferences.type || {})[0];\n\n    // Whitelist: Only allow conversion for known, pure RDF formats.\n    // Everything else (HTML, Markdown, Images, random XML/JSON) is treated as a file.\n    const SAFE_RDF_TYPES = new Set([\n      'text/turtle',\n      'application/ld+json',\n      'application/n-triples',\n      'application/n-quads',\n      'application/trig',\n      'text/n3',\n      'application/rdf+xml',\n      INTERNAL_QUADS // Necessary for GET requests to convert internal quads back to public formats\n    ]);\n\n    if (!SAFE_RDF_TYPES.has(contentType)) {\n      this.logger.debug(`Not converting ${identifier.path}: ${contentType} is not in RDF whitelist`);\n      return false;\n    }\n\n    try {\n      await this.inConverter.canHandle({ identifier, representation, preferences });\n      this.logger.debug(\n        `Converting ${identifier.path}: ${contentType} to ${preferencesType}`,\n      );\n      return true;\n    } catch (error) {\n      this.logger.debug(`Not converting ${identifier.path}: ${contentType} to ${preferencesType}. Error: ${error}`);\n      return false;\n    }\n  }\n\n  public override async getRepresentation(\n    identifier: ResourceIdentifier,\n    preferences: RepresentationPreferences,\n    conditions?: Conditions,\n  ): Promise<Representation> {\n    let representation = await super.getRepresentation(identifier, preferences, conditions);\n    if (await this.shouldConvert(identifier, representation, preferences)) {\n      representation = await this.outConverter.handleSafe({ identifier, representation, preferences });\n    }\n    return representation;\n  }\n\n  public override async addResource(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    // In case of containers, no content-type is required and the representation is not used.\n    try {\n      if (await this.shouldConvert(identifier, representation, this.inPreferences)) {\n        // We can potentially run into problems here if we convert a turtle document where the base IRI is required,\n        // since we don't know the resource IRI yet at this point.\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: this.inPreferences },\n        );\n      }\n    } catch (error) {\n      this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n    return this.source.addResource(identifier, representation, conditions);\n  }\n\n  public override async setRepresentation(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    try {\n      // When it is a metadata resource, convert it to Quads as those are expected in the later stores\n      if (this.metadataStrategy.isAuxiliaryIdentifier(identifier)) {\n        this.logger.debug(`Converting metadata resource ${identifier.path} to ${INTERNAL_QUADS}`);\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: { type: { [INTERNAL_QUADS]: 1 }}},\n        );\n      } else if (await this.shouldConvert(identifier, representation, this.inPreferences)) {\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: this.inPreferences },\n        );\n      }\n    } catch (error) {\n      this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n    return this.source.setRepresentation(identifier, representation, conditions);\n  }\n}\n"]}
+{"version":3,"file":"RepresentationPartialConvertingStore.js","sourceRoot":"","sources":["../../src/storage/RepresentationPartialConvertingStore.ts"],"names":[],"mappings":"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","sourcesContent":["import rdfParser from 'rdf-parse';\nimport { getLoggerFor } from 'global-logger-factory';\n\nimport {\n  PassthroughStore,\n  PassthroughConverter,\n  AuxiliaryStrategy,\n  ResourceStore,\n  RepresentationConverter,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Representation,\n  RepresentationConverterArgs,\n  Conditions,\n  \n  ChangeMap,\n  INTERNAL_QUADS,\n  APPLICATION_JSON,\n} from \"@solid/community-server\"\nimport { isSafeRdfDocumentContentType } from './rdf/RdfContentTypes'\n\ninterface RepresentationPartialConvertingStoreOptions {\n  outConverter?: RepresentationConverter\n  inConverter?: RepresentationConverter\n  inPreferences?: RepresentationPreferences\n}\n\n/**\n * A store that converts representations based on their content type.\n */\nexport class RepresentationPartialConvertingStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  protected readonly logger = getLoggerFor(this)\n\n  private readonly metadataStrategy: AuxiliaryStrategy\n  private readonly inConverter: RepresentationConverter\n  private readonly outConverter: RepresentationConverter\n  private readonly inPreferences: RepresentationPreferences\n  \n  constructor(\n    source: T,\n    metadataStrategy: AuxiliaryStrategy,\n    options: RepresentationPartialConvertingStoreOptions,\n  ) {\n    super(source)\n    this.metadataStrategy = metadataStrategy\n    this.inConverter = options.inConverter ?? new PassthroughConverter();\n    this.outConverter = options.outConverter ?? new PassthroughConverter();\n    this.inPreferences = options.inPreferences ?? {};\n\n    const inConverterClass = this.inConverter.constructor.name;\n    const outConverterClass = this.outConverter.constructor.name;\n    this.logger.debug(\n      `Initializing with inConverter: ${inConverterClass}, \n      outConverter: ${outConverterClass}, \n      inPreferences: ${JSON.stringify(this.inPreferences)}`);\n  }\n\n  private async shouldConvert(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    preferences: RepresentationPreferences,\n  ) {\n    if (representation.metadata.contentType === undefined) {\n      return false\n    }\n\n    const contentType = representation.metadata.contentType;\n    const preferencesType = Object.keys(preferences.type || {})[0];\n\n    if (preferences.type?.[contentType]) {\n      this.logger.debug(`Not converting ${identifier.path}: ${contentType} already satisfies preferences`);\n      return false;\n    }\n\n    if (contentType !== INTERNAL_QUADS && !isSafeRdfDocumentContentType(contentType)) {\n      this.logger.debug(`Not converting ${identifier.path}: ${contentType} is not in RDF whitelist`);\n      return false;\n    }\n\n    try {\n      await this.inConverter.canHandle({ identifier, representation, preferences });\n      this.logger.debug(\n        `Converting ${identifier.path}: ${contentType} to ${preferencesType}`,\n      );\n      return true;\n    } catch (error) {\n      this.logger.debug(`Not converting ${identifier.path}: ${contentType} to ${preferencesType}. Error: ${error}`);\n      return false;\n    }\n  }\n\n  public override async getRepresentation(\n    identifier: ResourceIdentifier,\n    preferences: RepresentationPreferences,\n    conditions?: Conditions,\n  ): Promise<Representation> {\n    let representation = await super.getRepresentation(identifier, preferences, conditions);\n    if (await this.shouldConvert(identifier, representation, preferences)) {\n      representation = await this.outConverter.handleSafe({ identifier, representation, preferences });\n    }\n    return representation;\n  }\n\n  public override async addResource(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    // In case of containers, no content-type is required and the representation is not used.\n    try {\n      if (await this.shouldConvert(identifier, representation, this.inPreferences)) {\n        // We can potentially run into problems here if we convert a turtle document where the base IRI is required,\n        // since we don't know the resource IRI yet at this point.\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: this.inPreferences },\n        );\n      }\n    } catch (error) {\n      this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n    return this.source.addResource(identifier, representation, conditions);\n  }\n\n  public override async setRepresentation(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    try {\n      // When it is a metadata resource, convert it to Quads as those are expected in the later stores\n      if (this.metadataStrategy.isAuxiliaryIdentifier(identifier)) {\n        this.logger.debug(`Converting metadata resource ${identifier.path} to ${INTERNAL_QUADS}`);\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: { type: { [INTERNAL_QUADS]: 1 }}},\n        );\n      } else if (await this.shouldConvert(identifier, representation, this.inPreferences)) {\n        representation = await this.inConverter.handleSafe(\n          { identifier, representation, preferences: this.inPreferences },\n        );\n      }\n    } catch (error) {\n      this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n    return this.source.setRepresentation(identifier, representation, conditions);\n  }\n}\n"]}

package/dist/storage/SparqlUpdateResourceStore.d.ts

@@ -1,9 +1,11 @@
 import { DataAccessorBasedStore, type ChangeMap, type ResourceIdentifier, type Patch, type Conditions, type DataAccessor, type IdentifierStrategy, type AuxiliaryStrategy, type Representation } from '@solid/community-server';
+import { type LocalFirstRdfRepresentationResolverLike } from '../solidfs/LocalFirstRdfRepresentationResolver';
 export interface SparqlUpdateResourceStoreOptions {
     accessor: DataAccessor;
     identifierStrategy: IdentifierStrategy;
     auxiliaryStrategy: AuxiliaryStrategy;
     metadataStrategy: AuxiliaryStrategy;
+    localFirstRdfRepresentationResolver?: LocalFirstRdfRepresentationResolverLike;
 }
 /**
  * ResourceStore that short-circuits PATCH into direct SPARQL UPDATE
@@ -12,8 +14,10 @@ export interface SparqlUpdateResourceStoreOptions {
 export declare class SparqlUpdateResourceStore extends DataAccessorBasedStore {
     private readonly generator;
     private readonly parser;
+    private readonly localFirstRdfRepresentationResolver;
     protected readonly logger: import("global-logger-factory").Logger<unknown>;
     constructor(options: SparqlUpdateResourceStoreOptions);
+    getRepresentation(identifier: ResourceIdentifier): Promise<Representation>;
     modifyResource(identifier: ResourceIdentifier, patch: Patch, conditions?: Conditions): Promise<ChangeMap>;
     /**
      * 只处理 SPARQL UPDATE (application/sparql-update)。

package/dist/storage/SparqlUpdateResourceStore.js

@@ -6,6 +6,7 @@ const sparqljs_1 = require("sparqljs");
 const community_server_1 = require("@solid/community-server");
 const StreamUtil_1 = require("@solid/community-server/dist/util/StreamUtil");
 const global_logger_factory_1 = require("global-logger-factory");
+const LocalFirstRdfRepresentationResolver_1 = require("../solidfs/LocalFirstRdfRepresentationResolver");
 /**
  * ResourceStore that short-circuits PATCH into direct SPARQL UPDATE
  * when the underlying DataAccessor supports it.
@@ -16,10 +17,22 @@ class SparqlUpdateResourceStore extends community_server_1.DataAccessorBasedStor
         this.generator = new sparqljs_1.Generator();
         this.parser = new sparqljs_1.Parser();
         this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.localFirstRdfRepresentationResolver = options.localFirstRdfRepresentationResolver ??
+            new LocalFirstRdfRepresentationResolver_1.LocalFirstRdfRepresentationResolver({
+                accessor: options.accessor,
+                metadataStrategy: options.metadataStrategy,
+            });
         // Check if identifierStrategy has baseUrl property (SingleRootIdentifierStrategy)
         const strategy = options.identifierStrategy;
         this.logger.info(`SparqlUpdateResourceStore initialized with identifierStrategy: ${options.identifierStrategy.constructor.name}, baseUrl: ${strategy.baseUrl ?? 'N/A'}`);
     }
+    async getRepresentation(identifier) {
+        const localRepresentation = await this.localFirstRdfRepresentationResolver.resolve(identifier);
+        if (localRepresentation) {
+            return localRepresentation;
+        }
+        return super.getRepresentation(identifier);
+    }
     // @ts-expect-error Upstream signature returns never; we return ChangeMap for successful PATCH.
     async modifyResource(identifier, patch, conditions) {
         this.logger.debug(`SparqlUpdateResourceStore.modifyResource called for ${identifier.path}`);

package/dist/storage/SparqlUpdateResourceStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"SparqlUpdateResourceStore.js","sourceRoot":"","sources":["../../src/storage/SparqlUpdateResourceStore.ts"],"names":[],"mappings":"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","sourcesContent":["import { DataFactory } from 'n3';\nimport { Generator as SparqlGenerator, Parser as SparqlParser, type GraphQuads, type UpdateOperation, type Update as SparqlUpdate } from 'sparqljs';\nimport {\n  DataAccessorBasedStore,\n  type ChangeMap,\n  type ResourceIdentifier,\n  type Patch,\n  NotImplementedHttpError,\n  type Conditions,\n  NotFoundHttpError,\n  RepresentationMetadata,\n  AS,\n  SOLID_AS,\n  BadRequestHttpError,\n  type DataAccessor,\n  type IdentifierStrategy,\n  type AuxiliaryStrategy,\n  type Representation,\n} from '@solid/community-server';\nimport type { SparqlUpdatePatch } from '@solid/community-server';\nimport { readableToString } from '@solid/community-server/dist/util/StreamUtil';\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport interface SparqlUpdateResourceStoreOptions {\n  accessor: DataAccessor;\n  identifierStrategy: IdentifierStrategy;\n  auxiliaryStrategy: AuxiliaryStrategy;\n  metadataStrategy: AuxiliaryStrategy;\n}\n\n/**\n * ResourceStore that short-circuits PATCH into direct SPARQL UPDATE\n * when the underlying DataAccessor supports it.\n */\nexport class SparqlUpdateResourceStore extends DataAccessorBasedStore {\n  private readonly generator = new SparqlGenerator();\n  private readonly parser = new SparqlParser();\n  protected override readonly logger = getLoggerFor(this);\n\n  public constructor(options: SparqlUpdateResourceStoreOptions) {\n    super(options.accessor, options.identifierStrategy, options.auxiliaryStrategy, options.metadataStrategy);\n    // Check if identifierStrategy has baseUrl property (SingleRootIdentifierStrategy)\n    const strategy = options.identifierStrategy as unknown as { baseUrl?: string };\n    this.logger.info(`SparqlUpdateResourceStore initialized with identifierStrategy: ${options.identifierStrategy.constructor.name}, baseUrl: ${strategy.baseUrl ?? 'N/A'}`);\n  }\n\n  // @ts-expect-error Upstream signature returns never; we return ChangeMap for successful PATCH.\n  public override async modifyResource(identifier: ResourceIdentifier, patch: Patch, conditions?: Conditions): Promise<ChangeMap> {\n    this.logger.debug(`SparqlUpdateResourceStore.modifyResource called for ${identifier.path}`);\n    this.logger.debug(`Patch has algebra: ${typeof (patch as SparqlUpdatePatch).algebra === 'object'}, metadata.contentType: ${patch.metadata?.contentType}`);\n\n    const accessor = (this as unknown as { accessor: unknown }).accessor as unknown;\n    if (!this.isSparqlCapable(accessor)) {\n      this.logger.debug('Accessor is not SPARQL capable');\n      throw new NotImplementedHttpError('SPARQL UPDATE not supported by this accessor');\n    }\n\n    // Keep the default condition validation semantics\n    if (conditions) {\n      let metadata: RepresentationMetadata | undefined;\n      try {\n        metadata = await accessor.getMetadata(identifier);\n      } catch (error: unknown) {\n        if (!NotFoundHttpError.isInstance(error)) {\n          throw error;\n        }\n      }\n      this.validateConditions(conditions, metadata);\n    }\n\n    const sparqlUpdate = await this.toSparqlUpdate(patch, identifier);\n    if (!sparqlUpdate) {\n      this.logger.debug(`toSparqlUpdate returned undefined for ${identifier.path}, falling back to CSS handler`);\n      throw new NotImplementedHttpError('Unsupported PATCH payload for SPARQL conversion');\n    }\n\n    this.logger.debug(`Applying SPARQL PATCH to ${identifier.path}: ${sparqlUpdate}`);\n    await accessor.executeSparqlUpdate(sparqlUpdate, identifier.path);\n\n    // PATCH does not affect containment; mark the target resource as updated.\n    const changes = new Map() as ChangeMap;\n    changes.set(identifier, new RepresentationMetadata(identifier, { [SOLID_AS.activity]: AS.terms.Update }));\n    return changes;\n  }\n\n  /**\n   * 只处理 SPARQL UPDATE (application/sparql-update)。\n   * N3 Patch 和其他类型返回 undefined，让 CSS PatchingStore 回退到 get-patch-set 逻辑。\n   */\n  private async toSparqlUpdate(patch: Patch, identifier: ResourceIdentifier): Promise<string | undefined> {\n    // 只处理 SPARQL UPDATE，其他类型（包括 N3 Patch）回退到 CSS 默认处理\n    if (!this.isSparqlUpdatePatch(patch)) {\n      return undefined;\n    }\n\n    const updateText = await readableToString(patch.data);\n    return this.normalizeGraphs(updateText, identifier);\n  }\n\n  /**\n   * Ensure SPARQL UPDATE targets the resource graph (CSS stores documents in named graphs).\n   */\n  private normalizeGraphs(updateText: string, identifier: ResourceIdentifier): string | undefined {\n    const graph = DataFactory.namedNode(identifier.path);\n    const identifierStrategy = (this as unknown as { identifierStrategy: { supportsIdentifier: (id: ResourceIdentifier) => boolean }}).identifierStrategy;\n\n    const assertGraphAllowed = (value: unknown): void => {\n      if (!value || typeof value !== 'object') {\n        return;\n      }\n      const term = value as { termType?: string; value?: string };\n      if (term.termType === 'NamedNode' && term.value && !identifierStrategy.supportsIdentifier({ path: term.value })) {\n        throw new BadRequestHttpError(`GRAPH ${term.value} is outside the configured identifier space.`);\n      }\n    };\n    const wrapDefaultGraph = (text: string): string => {\n      const insert = /INSERT\\s+DATA\\s*{\\s*([^}]*)}/is;\n      const del = /DELETE\\s+DATA\\s*{\\s*([^}]*)}/is;\n      const rewrite = (regex: RegExp, label: string, input: string): string =>\n        input.replace(regex, (_match, body) => `${label} { GRAPH <${graph.value}> { ${body} } }`);\n      let out = text;\n      if (insert.test(out)) {\n        out = rewrite(insert, 'INSERT DATA', out);\n      }\n      if (del.test(out)) {\n        out = rewrite(del, 'DELETE DATA', out);\n      }\n      return out;\n    };\n\n    const rewriteTriples = (triples?: any[], targetGraph = graph): any[] => {\n      if (!triples) return [];\n      return triples.map((triple: any): any => ({\n        ...triple,\n        graph: (!triple.graph || triple.graph.termType === 'DefaultGraph') ? targetGraph : triple.graph,\n      }));\n    };\n\n    const rewritePattern = (pattern: any): any => {\n      if (pattern.type === 'bgp') {\n        return { ...pattern, triples: rewriteTriples(pattern.triples) };\n      }\n      if (pattern.type === 'graph') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'group') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'optional') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'union') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'minus') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'filter') {\n        return pattern; // FILTER doesn't contain triples, pass through\n      }\n      if (pattern.type === 'bind') {\n        return pattern; // BIND doesn't contain triples, pass through\n      }\n      if (pattern.type === 'values') {\n        return pattern; // VALUES doesn't contain triples, pass through\n      }\n      if (pattern.type === 'service') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      return pattern;\n    };\n\n    const toGraphQuads = (items?: any[]): GraphQuads[] | undefined => {\n      if (!items) return items;\n      return items.map((item: any): GraphQuads => {\n        if (item?.type === 'graph') {\n          assertGraphAllowed(item.name);\n          return {\n            ...item,\n            name: item.name ?? graph,\n            triples: rewriteTriples(item.triples, item.name ?? graph),\n          };\n        }\n        // Treat as plain quad\n        return {\n          type: 'graph',\n          name: graph,\n          triples: rewriteTriples([ item ], graph),\n        };\n      });\n    };\n\n    try {\n      console.log(`[normalizeGraphs] Input SPARQL (first 500 chars): ${updateText.slice(0, 500)}`);\n      const parsed = this.parser.parse(updateText) as unknown as SparqlUpdate;\n\n      // Explicitly reject SPARQL Queries (SELECT, ASK, CONSTRUCT) in PATCH\n      if ((parsed as any).type === 'query') {\n        this.logger.warn(`Received SPARQL Query in PATCH request for ${identifier.path}. SPARQL PATCH only supports UPDATE operations.`);\n        return undefined;\n      }\n\n      const collect = (ops: any[], key: 'delete' | 'insert'): any[] =>\n        ops.flatMap((op): any[] => {\n          const entries = op[key];\n          if (!entries) return [];\n          if (Array.isArray(entries)) {\n            return entries.flatMap((entry: any): any[] =>\n              entry.triples ? entry.triples : (entry.quads ?? []));\n          }\n          return [];\n        });\n    const deleteTriples = collect(parsed.updates as any[], 'delete');\n    const insertTriples = collect(parsed.updates as any[], 'insert');\n    const hasVariables = [...deleteTriples, ...insertTriples].some((t: any): boolean =>\n      t.subject?.termType === 'Variable' || t.predicate?.termType === 'Variable' || t.object?.termType === 'Variable');\n\n      const simpleOps = parsed.updates.every((op: any): boolean =>\n        [ 'delete', 'insert', 'insertdelete', 'deleteinsert' ].includes(op.updateType) &&\n        (!op.where || op.where.length === 0) &&\n        !hasVariables);\n\n      this.logger.debug(`[normalizeGraphs] simpleOps=${simpleOps}, hasVariables=${hasVariables}, deleteTriples=${deleteTriples.length}, insertTriples=${insertTriples.length}`);\n      this.logger.debug(`[normalizeGraphs] updateTypes: ${parsed.updates.map((op: any) => op.updateType).join(', ')}`);\n\n      if (simpleOps && deleteTriples.length + insertTriples.length > 0) {\n        const termToString = (term: any): string => {\n          if (term.termType === 'NamedNode') {\n            return `<${term.value}>`;\n          }\n          if (term.termType === 'Literal') {\n            // Escape special characters in literal values\n            const hasQuotes = term.value.includes('\"');\n            const hasNewlines = term.value.includes('\\n') || term.value.includes('\\r');\n\n            let escaped: string;\n            let useTripleQuotes = false;\n\n            if (hasQuotes || hasNewlines) {\n              // Use triple-quoted strings for values with quotes or newlines\n              useTripleQuotes = true;\n              escaped = term.value;\n              // Escape triple-quote sequences\n              escaped = escaped.replace(/\"\"\"/g, '\"\\\\\"\\\\\"\"');\n              // Escape trailing quotes to avoid \"\"\"content\"\"\"\" sequences\n              if (escaped.endsWith('\"')) {\n                const match = escaped.match(/\"*$/);\n                const trailingQuotes = match ? match[0].length : 0;\n                if (trailingQuotes > 0) {\n                  escaped = escaped.slice(0, -trailingQuotes) + '\\\\\"'.repeat(trailingQuotes);\n                }\n              }\n            } else {\n              // Regular escaping for simple strings\n              escaped = term.value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n            }\n\n            const quote = useTripleQuotes ? '\"\"\"' : '\"';\n\n            // Handle language tags and datatypes\n            if (term.language) {\n              return `${quote}${escaped}${quote}@${term.language}`;\n            }\n            if (term.datatype && term.datatype.value !== 'http://www.w3.org/2001/XMLSchema#string') {\n              return `${quote}${escaped}${quote}^^<${term.datatype.value}>`;\n            }\n            return `${quote}${escaped}${quote}`;\n          }\n          if (term.termType === 'BlankNode') {\n            return `_:${term.value}`;\n          }\n          // Fallback for unknown term types\n          return `<${term.value}>`;\n        };\n        const toTripleStr = (triples: any[]): string =>\n          triples.map((t): string => `${termToString(t.subject)} ${termToString(t.predicate)} ${termToString(t.object)} .`).join(' ');\n        let parts: string[] = [];\n        if (deleteTriples.length > 0) {\n          parts.push(`DELETE DATA { GRAPH <${graph.value}> { ${toTripleStr(deleteTriples)} } }`);\n        }\n        if (insertTriples.length > 0) {\n          parts.push(`INSERT DATA { GRAPH <${graph.value}> { ${toTripleStr(insertTriples)} } }`);\n        }\n        const normalizedSimple = parts.join(';\\n');\n        this.logger.verbose(`Normalized SPARQL UPDATE for ${identifier.path}: ${normalizedSimple}`);\n        return normalizedSimple;\n      }\n\n      parsed.updates = parsed.updates.map((op: any): UpdateOperation => {\n        switch (op.updateType) {\n          case 'deleteinsert':\n          case 'insertdelete':\n            return {\n              ...op,\n              delete: toGraphQuads(op.delete),\n              insert: toGraphQuads(op.insert),\n              where: op.where && op.where.length > 0 ? [ { type: 'graph', name: graph, patterns: op.where.map(rewritePattern) } ] : [],\n            };\n          case 'delete':\n          case 'insert': {\n            const deleteQuads = toGraphQuads(op.delete) ?? [];\n            const insertQuads = toGraphQuads(op.insert) ?? [];\n            return {\n              updateType: 'insertdelete',\n              delete: deleteQuads,\n              insert: insertQuads,\n              where: op.where && op.where.length > 0 ? [ { type: 'graph', name: graph, patterns: op.where.map(rewritePattern) } ] : [],\n            };\n          }\n          default:\n            return op;\n        }\n      });\n      const normalized = this.generator.stringify(parsed);\n      this.logger.verbose(`Normalized SPARQL UPDATE for ${identifier.path}: ${normalized}`);\n      return normalized;\n    } catch (error: unknown) {\n      console.log(`[normalizeGraphs] Parse FAILED for ${identifier.path}: ${error}`);\n      console.log(`[normalizeGraphs] Input was: ${updateText.slice(0, 300)}`);\n      const fallbackResult = wrapDefaultGraph(updateText);\n      console.log(`[normalizeGraphs] Fallback result: ${fallbackResult.slice(0, 300)}`);\n      return fallbackResult;\n    }\n  }\n\n  private isSparqlUpdatePatch(patch: Patch): patch is SparqlUpdatePatch {\n    return typeof (patch as SparqlUpdatePatch).algebra === 'object';\n  }\n\n  private isSparqlCapable(accessor: unknown): accessor is {\n    executeSparqlUpdate: (query: string, baseIri?: string) => Promise<void>;\n    getMetadata: (identifier: ResourceIdentifier) => Promise<RepresentationMetadata>;\n  } {\n    return typeof accessor === 'object' &&\n      accessor !== null &&\n      typeof (accessor as { executeSparqlUpdate?: unknown }).executeSparqlUpdate === 'function' &&\n      typeof (accessor as { getMetadata?: unknown }).getMetadata === 'function';\n  }\n\n  public override async setRepresentation(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap> {\n    return super.setRepresentation(identifier, representation, conditions);\n  }\n}\n"]}
+{"version":3,"file":"SparqlUpdateResourceStore.js","sourceRoot":"","sources":["../../src/storage/SparqlUpdateResourceStore.ts"],"names":[],"mappings":"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","sourcesContent":["import { DataFactory } from 'n3';\nimport { Generator as SparqlGenerator, Parser as SparqlParser, type GraphQuads, type UpdateOperation, type Update as SparqlUpdate } from 'sparqljs';\nimport {\n  DataAccessorBasedStore,\n  type ChangeMap,\n  type ResourceIdentifier,\n  type Patch,\n  NotImplementedHttpError,\n  type Conditions,\n  NotFoundHttpError,\n  RepresentationMetadata,\n  AS,\n  SOLID_AS,\n  BadRequestHttpError,\n  type DataAccessor,\n  type IdentifierStrategy,\n  type AuxiliaryStrategy,\n  type Representation,\n} from '@solid/community-server';\nimport type { SparqlUpdatePatch } from '@solid/community-server';\nimport { readableToString } from '@solid/community-server/dist/util/StreamUtil';\nimport { getLoggerFor } from 'global-logger-factory';\nimport {\n  LocalFirstRdfRepresentationResolver,\n  type LocalFirstRdfRepresentationResolverLike,\n} from '../solidfs/LocalFirstRdfRepresentationResolver';\n\nexport interface SparqlUpdateResourceStoreOptions {\n  accessor: DataAccessor;\n  identifierStrategy: IdentifierStrategy;\n  auxiliaryStrategy: AuxiliaryStrategy;\n  metadataStrategy: AuxiliaryStrategy;\n  localFirstRdfRepresentationResolver?: LocalFirstRdfRepresentationResolverLike;\n}\n\n/**\n * ResourceStore that short-circuits PATCH into direct SPARQL UPDATE\n * when the underlying DataAccessor supports it.\n */\nexport class SparqlUpdateResourceStore extends DataAccessorBasedStore {\n  private readonly generator = new SparqlGenerator();\n  private readonly parser = new SparqlParser();\n  private readonly localFirstRdfRepresentationResolver: LocalFirstRdfRepresentationResolverLike;\n  protected override readonly logger = getLoggerFor(this);\n\n  public constructor(options: SparqlUpdateResourceStoreOptions) {\n    super(options.accessor, options.identifierStrategy, options.auxiliaryStrategy, options.metadataStrategy);\n    this.localFirstRdfRepresentationResolver = options.localFirstRdfRepresentationResolver ??\n      new LocalFirstRdfRepresentationResolver({\n        accessor: options.accessor,\n        metadataStrategy: options.metadataStrategy,\n      });\n    // Check if identifierStrategy has baseUrl property (SingleRootIdentifierStrategy)\n    const strategy = options.identifierStrategy as unknown as { baseUrl?: string };\n    this.logger.info(`SparqlUpdateResourceStore initialized with identifierStrategy: ${options.identifierStrategy.constructor.name}, baseUrl: ${strategy.baseUrl ?? 'N/A'}`);\n  }\n\n  public override async getRepresentation(identifier: ResourceIdentifier): Promise<Representation> {\n    const localRepresentation = await this.localFirstRdfRepresentationResolver.resolve(identifier);\n    if (localRepresentation) {\n      return localRepresentation;\n    }\n\n    return super.getRepresentation(identifier);\n  }\n\n  // @ts-expect-error Upstream signature returns never; we return ChangeMap for successful PATCH.\n  public override async modifyResource(identifier: ResourceIdentifier, patch: Patch, conditions?: Conditions): Promise<ChangeMap> {\n    this.logger.debug(`SparqlUpdateResourceStore.modifyResource called for ${identifier.path}`);\n    this.logger.debug(`Patch has algebra: ${typeof (patch as SparqlUpdatePatch).algebra === 'object'}, metadata.contentType: ${patch.metadata?.contentType}`);\n\n    const accessor = (this as unknown as { accessor: unknown }).accessor as unknown;\n    if (!this.isSparqlCapable(accessor)) {\n      this.logger.debug('Accessor is not SPARQL capable');\n      throw new NotImplementedHttpError('SPARQL UPDATE not supported by this accessor');\n    }\n\n    // Keep the default condition validation semantics\n    if (conditions) {\n      let metadata: RepresentationMetadata | undefined;\n      try {\n        metadata = await accessor.getMetadata(identifier);\n      } catch (error: unknown) {\n        if (!NotFoundHttpError.isInstance(error)) {\n          throw error;\n        }\n      }\n      this.validateConditions(conditions, metadata);\n    }\n\n    const sparqlUpdate = await this.toSparqlUpdate(patch, identifier);\n    if (!sparqlUpdate) {\n      this.logger.debug(`toSparqlUpdate returned undefined for ${identifier.path}, falling back to CSS handler`);\n      throw new NotImplementedHttpError('Unsupported PATCH payload for SPARQL conversion');\n    }\n\n    this.logger.debug(`Applying SPARQL PATCH to ${identifier.path}: ${sparqlUpdate}`);\n    await accessor.executeSparqlUpdate(sparqlUpdate, identifier.path);\n\n    // PATCH does not affect containment; mark the target resource as updated.\n    const changes = new Map() as ChangeMap;\n    changes.set(identifier, new RepresentationMetadata(identifier, { [SOLID_AS.activity]: AS.terms.Update }));\n    return changes;\n  }\n\n  /**\n   * 只处理 SPARQL UPDATE (application/sparql-update)。\n   * N3 Patch 和其他类型返回 undefined，让 CSS PatchingStore 回退到 get-patch-set 逻辑。\n   */\n  private async toSparqlUpdate(patch: Patch, identifier: ResourceIdentifier): Promise<string | undefined> {\n    // 只处理 SPARQL UPDATE，其他类型（包括 N3 Patch）回退到 CSS 默认处理\n    if (!this.isSparqlUpdatePatch(patch)) {\n      return undefined;\n    }\n\n    const updateText = await readableToString(patch.data);\n    return this.normalizeGraphs(updateText, identifier);\n  }\n\n  /**\n   * Ensure SPARQL UPDATE targets the resource graph (CSS stores documents in named graphs).\n   */\n  private normalizeGraphs(updateText: string, identifier: ResourceIdentifier): string | undefined {\n    const graph = DataFactory.namedNode(identifier.path);\n    const identifierStrategy = (this as unknown as { identifierStrategy: { supportsIdentifier: (id: ResourceIdentifier) => boolean }}).identifierStrategy;\n\n    const assertGraphAllowed = (value: unknown): void => {\n      if (!value || typeof value !== 'object') {\n        return;\n      }\n      const term = value as { termType?: string; value?: string };\n      if (term.termType === 'NamedNode' && term.value && !identifierStrategy.supportsIdentifier({ path: term.value })) {\n        throw new BadRequestHttpError(`GRAPH ${term.value} is outside the configured identifier space.`);\n      }\n    };\n    const wrapDefaultGraph = (text: string): string => {\n      const insert = /INSERT\\s+DATA\\s*{\\s*([^}]*)}/is;\n      const del = /DELETE\\s+DATA\\s*{\\s*([^}]*)}/is;\n      const rewrite = (regex: RegExp, label: string, input: string): string =>\n        input.replace(regex, (_match, body) => `${label} { GRAPH <${graph.value}> { ${body} } }`);\n      let out = text;\n      if (insert.test(out)) {\n        out = rewrite(insert, 'INSERT DATA', out);\n      }\n      if (del.test(out)) {\n        out = rewrite(del, 'DELETE DATA', out);\n      }\n      return out;\n    };\n\n    const rewriteTriples = (triples?: any[], targetGraph = graph): any[] => {\n      if (!triples) return [];\n      return triples.map((triple: any): any => ({\n        ...triple,\n        graph: (!triple.graph || triple.graph.termType === 'DefaultGraph') ? targetGraph : triple.graph,\n      }));\n    };\n\n    const rewritePattern = (pattern: any): any => {\n      if (pattern.type === 'bgp') {\n        return { ...pattern, triples: rewriteTriples(pattern.triples) };\n      }\n      if (pattern.type === 'graph') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'group') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'optional') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'union') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'minus') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      if (pattern.type === 'filter') {\n        return pattern; // FILTER doesn't contain triples, pass through\n      }\n      if (pattern.type === 'bind') {\n        return pattern; // BIND doesn't contain triples, pass through\n      }\n      if (pattern.type === 'values') {\n        return pattern; // VALUES doesn't contain triples, pass through\n      }\n      if (pattern.type === 'service') {\n        return { ...pattern, patterns: pattern.patterns?.map(rewritePattern) ?? [] };\n      }\n      return pattern;\n    };\n\n    const toGraphQuads = (items?: any[]): GraphQuads[] | undefined => {\n      if (!items) return items;\n      return items.map((item: any): GraphQuads => {\n        if (item?.type === 'graph') {\n          assertGraphAllowed(item.name);\n          return {\n            ...item,\n            name: item.name ?? graph,\n            triples: rewriteTriples(item.triples, item.name ?? graph),\n          };\n        }\n        // Treat as plain quad\n        return {\n          type: 'graph',\n          name: graph,\n          triples: rewriteTriples([ item ], graph),\n        };\n      });\n    };\n\n    try {\n      console.log(`[normalizeGraphs] Input SPARQL (first 500 chars): ${updateText.slice(0, 500)}`);\n      const parsed = this.parser.parse(updateText) as unknown as SparqlUpdate;\n\n      // Explicitly reject SPARQL Queries (SELECT, ASK, CONSTRUCT) in PATCH\n      if ((parsed as any).type === 'query') {\n        this.logger.warn(`Received SPARQL Query in PATCH request for ${identifier.path}. SPARQL PATCH only supports UPDATE operations.`);\n        return undefined;\n      }\n\n      const collect = (ops: any[], key: 'delete' | 'insert'): any[] =>\n        ops.flatMap((op): any[] => {\n          const entries = op[key];\n          if (!entries) return [];\n          if (Array.isArray(entries)) {\n            return entries.flatMap((entry: any): any[] =>\n              entry.triples ? entry.triples : (entry.quads ?? []));\n          }\n          return [];\n        });\n    const deleteTriples = collect(parsed.updates as any[], 'delete');\n    const insertTriples = collect(parsed.updates as any[], 'insert');\n    const hasVariables = [...deleteTriples, ...insertTriples].some((t: any): boolean =>\n      t.subject?.termType === 'Variable' || t.predicate?.termType === 'Variable' || t.object?.termType === 'Variable');\n\n      const simpleOps = parsed.updates.every((op: any): boolean =>\n        [ 'delete', 'insert', 'insertdelete', 'deleteinsert' ].includes(op.updateType) &&\n        (!op.where || op.where.length === 0) &&\n        !hasVariables);\n\n      this.logger.debug(`[normalizeGraphs] simpleOps=${simpleOps}, hasVariables=${hasVariables}, deleteTriples=${deleteTriples.length}, insertTriples=${insertTriples.length}`);\n      this.logger.debug(`[normalizeGraphs] updateTypes: ${parsed.updates.map((op: any) => op.updateType).join(', ')}`);\n\n      if (simpleOps && deleteTriples.length + insertTriples.length > 0) {\n        const termToString = (term: any): string => {\n          if (term.termType === 'NamedNode') {\n            return `<${term.value}>`;\n          }\n          if (term.termType === 'Literal') {\n            // Escape special characters in literal values\n            const hasQuotes = term.value.includes('\"');\n            const hasNewlines = term.value.includes('\\n') || term.value.includes('\\r');\n\n            let escaped: string;\n            let useTripleQuotes = false;\n\n            if (hasQuotes || hasNewlines) {\n              // Use triple-quoted strings for values with quotes or newlines\n              useTripleQuotes = true;\n              escaped = term.value;\n              // Escape triple-quote sequences\n              escaped = escaped.replace(/\"\"\"/g, '\"\\\\\"\\\\\"\"');\n              // Escape trailing quotes to avoid \"\"\"content\"\"\"\" sequences\n              if (escaped.endsWith('\"')) {\n                const match = escaped.match(/\"*$/);\n                const trailingQuotes = match ? match[0].length : 0;\n                if (trailingQuotes > 0) {\n                  escaped = escaped.slice(0, -trailingQuotes) + '\\\\\"'.repeat(trailingQuotes);\n                }\n              }\n            } else {\n              // Regular escaping for simple strings\n              escaped = term.value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n            }\n\n            const quote = useTripleQuotes ? '\"\"\"' : '\"';\n\n            // Handle language tags and datatypes\n            if (term.language) {\n              return `${quote}${escaped}${quote}@${term.language}`;\n            }\n            if (term.datatype && term.datatype.value !== 'http://www.w3.org/2001/XMLSchema#string') {\n              return `${quote}${escaped}${quote}^^<${term.datatype.value}>`;\n            }\n            return `${quote}${escaped}${quote}`;\n          }\n          if (term.termType === 'BlankNode') {\n            return `_:${term.value}`;\n          }\n          // Fallback for unknown term types\n          return `<${term.value}>`;\n        };\n        const toTripleStr = (triples: any[]): string =>\n          triples.map((t): string => `${termToString(t.subject)} ${termToString(t.predicate)} ${termToString(t.object)} .`).join(' ');\n        let parts: string[] = [];\n        if (deleteTriples.length > 0) {\n          parts.push(`DELETE DATA { GRAPH <${graph.value}> { ${toTripleStr(deleteTriples)} } }`);\n        }\n        if (insertTriples.length > 0) {\n          parts.push(`INSERT DATA { GRAPH <${graph.value}> { ${toTripleStr(insertTriples)} } }`);\n        }\n        const normalizedSimple = parts.join(';\\n');\n        this.logger.verbose(`Normalized SPARQL UPDATE for ${identifier.path}: ${normalizedSimple}`);\n        return normalizedSimple;\n      }\n\n      parsed.updates = parsed.updates.map((op: any): UpdateOperation => {\n        switch (op.updateType) {\n          case 'deleteinsert':\n          case 'insertdelete':\n            return {\n              ...op,\n              delete: toGraphQuads(op.delete),\n              insert: toGraphQuads(op.insert),\n              where: op.where && op.where.length > 0 ? [ { type: 'graph', name: graph, patterns: op.where.map(rewritePattern) } ] : [],\n            };\n          case 'delete':\n          case 'insert': {\n            const deleteQuads = toGraphQuads(op.delete) ?? [];\n            const insertQuads = toGraphQuads(op.insert) ?? [];\n            return {\n              updateType: 'insertdelete',\n              delete: deleteQuads,\n              insert: insertQuads,\n              where: op.where && op.where.length > 0 ? [ { type: 'graph', name: graph, patterns: op.where.map(rewritePattern) } ] : [],\n            };\n          }\n          default:\n            return op;\n        }\n      });\n      const normalized = this.generator.stringify(parsed);\n      this.logger.verbose(`Normalized SPARQL UPDATE for ${identifier.path}: ${normalized}`);\n      return normalized;\n    } catch (error: unknown) {\n      console.log(`[normalizeGraphs] Parse FAILED for ${identifier.path}: ${error}`);\n      console.log(`[normalizeGraphs] Input was: ${updateText.slice(0, 300)}`);\n      const fallbackResult = wrapDefaultGraph(updateText);\n      console.log(`[normalizeGraphs] Fallback result: ${fallbackResult.slice(0, 300)}`);\n      return fallbackResult;\n    }\n  }\n\n  private isSparqlUpdatePatch(patch: Patch): patch is SparqlUpdatePatch {\n    return typeof (patch as SparqlUpdatePatch).algebra === 'object';\n  }\n\n  private isSparqlCapable(accessor: unknown): accessor is {\n    executeSparqlUpdate: (query: string, baseIri?: string) => Promise<void>;\n    getMetadata: (identifier: ResourceIdentifier) => Promise<RepresentationMetadata>;\n  } {\n    return typeof accessor === 'object' &&\n      accessor !== null &&\n      typeof (accessor as { executeSparqlUpdate?: unknown }).executeSparqlUpdate === 'function' &&\n      typeof (accessor as { getMetadata?: unknown }).getMetadata === 'function';\n  }\n\n  public override async setRepresentation(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap> {\n    return super.setRepresentation(identifier, representation, conditions);\n  }\n}\n"]}

package/dist/storage/SparqlUpdateResourceStore.jsonld

@@ -29,6 +29,18 @@
         {
           "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore_options_metadataStrategy",
           "range": "css:dist/http/auxiliary/AuxiliaryStrategy.jsonld#AuxiliaryStrategy"
+        },
+        {
+          "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore_options_localFirstRdfRepresentationResolver",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/solidfs/LocalFirstRdfRepresentationResolver.jsonld#LocalFirstRdfRepresentationResolverLike",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
         }
       ],
       "memberFields": [
@@ -40,6 +52,10 @@
           "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_parser",
           "memberFieldName": "parser"
         },
+        {
+          "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_localFirstRdfRepresentationResolver",
+          "memberFieldName": "localFirstRdfRepresentationResolver"
+        },
         {
           "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_logger",
           "memberFieldName": "logger",
@@ -51,6 +67,10 @@
           "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_constructor",
           "memberFieldName": "constructor"
         },
+        {
+          "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_getRepresentation",
+          "memberFieldName": "getRepresentation"
+        },
         {
           "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore__member_modifyResource",
           "memberFieldName": "modifyResource"
@@ -103,6 +123,12 @@
               "value": {
                 "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore_options_metadataStrategy"
               }
+            },
+            {
+              "keyRaw": "localFirstRdfRepresentationResolver",
+              "value": {
+                "@id": "undefineds:dist/storage/SparqlUpdateResourceStore.jsonld#SparqlUpdateResourceStore_options_localFirstRdfRepresentationResolver"
+              }
             }
           ]
         }

package/dist/storage/accessors/MixDataAccessor.d.ts

@@ -1,10 +1,34 @@
-import type { Readable } from 'stream';
+import { Readable } from 'stream';
+import type { Quad } from '@rdfjs/types';
 import { RepresentationMetadata } from '@solid/community-server';
 import type { Representation, ResourceIdentifier, Guarded, DataAccessor } from '@solid/community-server';
+import type { RdfSourceInput } from '../rdf/types';
+export interface LocalRdfDocument {
+    data: Guarded<Readable>;
+    metadata: RepresentationMetadata;
+}
+export interface LocalRdfReadableAccessor {
+    getLocalRdfDocument(identifier: ResourceIdentifier): Promise<LocalRdfDocument>;
+}
+export interface LocalRdfIndexAccessor {
+    syncLocalRdfDocument(identifier: ResourceIdentifier, data?: Guarded<Readable>, contentType?: string, options?: LocalRdfSyncOptions): Promise<void>;
+    deleteLocalRdfIndex(identifier: ResourceIdentifier): Promise<void>;
+}
+export interface LocalRdfSyncOptions {
+    source?: string;
+    workspace?: string;
+    localPath?: string;
+    sourceVersion?: string;
+}
+export interface SourceScopedStructuredRdfAccessor {
+    writeRdfSourceDocument(identifier: ResourceIdentifier, quads: Quad[], metadata: RepresentationMetadata, source: RdfSourceInput): Promise<void>;
+    deleteRdfSourceDocument(identifier: ResourceIdentifier): Promise<void>;
+}
 /**
  * MixDataAccessor - Routes data to appropriate storage based on content type
  *
  * - RDF data (internal/quads) -> structuredDataAccessor (Quadstore or QuintStore)
+ * - RDF file mirrors (.ttl/.jsonld) -> rdfFileDataAccessor (local FileSystem)
  * - Other data (binary, text, etc.) -> unstructuredDataAccessor (FileSystem, Minio, etc.)
  *
  * This uses composition instead of inheritance, allowing any DataAccessor
@@ -12,11 +36,13 @@ import type { Representation, ResourceIdentifier, Guarded, DataAccessor } from '
  */
 export declare class MixDataAccessor implements DataAccessor {
     protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly rdfSparqlAdapter;
     private readonly structuredDataAccessor;
     private readonly unstructuredDataAccessor;
+    private readonly rdfFileDataAccessor;
     private readonly presignedRedirectEnabled;
     private readonly mirrorContainersToUnstructured;
-    constructor(structuredDataAccessor: DataAccessor, unstructuredDataAccessor: DataAccessor, presignedRedirectEnabled?: boolean, mirrorContainersToUnstructured?: boolean);
+    constructor(structuredDataAccessor: DataAccessor, unstructuredDataAccessor: DataAccessor, presignedRedirectEnabled?: boolean, mirrorContainersToUnstructured?: boolean, rdfFileDataAccessor?: DataAccessor);
     /**
      * This accessor supports all types of data.
      */
@@ -26,6 +52,14 @@ export declare class MixDataAccessor implements DataAccessor {
      */
     private isUnstructured;
     getData(identifier: ResourceIdentifier): Promise<Guarded<Readable>>;
+    /**
+     * Read the local RDF file mirror used by SolidFS/local-first HTTP reads.
+     *
+     * `getData()` intentionally keeps returning the structured quad stream for
+     * CSS internals. This method is the explicit file-content path for callers
+     * that need a real Turtle/JSON-LD byte stream.
+     */
+    getLocalRdfDocument(identifier: ResourceIdentifier): Promise<LocalRdfDocument>;
     getMetadata(identifier: ResourceIdentifier): Promise<RepresentationMetadata>;
     getChildren(identifier: ResourceIdentifier): AsyncIterableIterator<RepresentationMetadata>;
     writeContainer(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void>;
@@ -33,14 +67,61 @@ export declare class MixDataAccessor implements DataAccessor {
     writeMetadata(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void>;
     deleteResource(identifier: ResourceIdentifier): Promise<void>;
     /**
-     * Execute SPARQL UPDATE on structured data accessor.
-     * Delegates to the underlying structuredDataAccessor if it supports SPARQL.
+     * Execute SPARQL UPDATE.
+     *
+     * Supported embedded deltas patch the local RDF authority file first and then
+     * rebuild the structured RDF index. Unsupported shapes keep using the
+     * compatibility accessor until the embedded engine covers them.
      */
     executeSparqlUpdate(query: string, baseIri?: string): Promise<void>;
+    private executeLocalRdfSparqlUpdate;
+    private applyLocalRdfDelta;
+    private assertLocalRdfDeltaTargetsGraph;
+    private queryLocalUpdateBindings;
+    private queryGraphTerms;
+    private readLocalRdfTextOrEmpty;
+    private writeLocalRdfAuthority;
+    private toDefaultGraphQuad;
+    private toGraphQuad;
+    private quadKey;
+    /**
+     * Rebuild the structured RDF index from an already-written local RDF file.
+     *
+     * SolidFS uses this after tools edit `.ttl`/`.jsonld` files directly. The
+     * local file remains the content authority; the structured accessor is only
+     * refreshed as query/index state.
+     */
+    syncLocalRdfDocument(identifier: ResourceIdentifier, data?: Guarded<Readable>, contentType?: string, options?: LocalRdfSyncOptions): Promise<void>;
+    deleteLocalRdfIndex(identifier: ResourceIdentifier): Promise<void>;
+    private writeRdfDocument;
+    private writeStructuredRdfIndex;
+    private refreshLocalRdfMirror;
+    private getLocalRdfMetadata;
+    private getExistingLocalRdfMetadata;
+    private createLocalRdfMetadata;
+    private localRdfContentType;
+    private sourceScopedStructuredAccessor;
+    private rdfSourceInput;
+    private relativePathFromWorkspace;
+    private isByLineRdfIdentifier;
+    private isRdfDocumentIdentifier;
+    private isLocalMirroredRdf;
+    private serializeQuadsForLocalFile;
+    private serializeNQuads;
+    private parseLocalRdf;
+    private readStreamText;
     /**
      * Write unstructured document: store data in unstructured accessor,
      * then save metadata in structured accessor.
      */
     private writeUnstructuredDocument;
+    private deleteUnstructuredResourceIfPresent;
+    private deleteRdfFileResourceIfPresent;
+    private ensureUnstructuredParentContainers;
+    private ensureRdfFileParentContainers;
+    private ensureParentContainers;
+    private writeContainerIfMissing;
+    private sameIdentifier;
+    private parentContainer;
     private invalidateMetadataCache;
 }