@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/ObservableResourceStore.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ObservableResourceStore - 可观察的资源存储包装器
+ *
+ * 在资源变更时发出事件，供订阅者（如 UsageTracker、VectorIndexer）处理。
+ * 采用事件驱动模式，解耦存储操作与副作用逻辑。
+ */
+import { PassthroughStore } from '@solid/community-server';
+import type { ChangeMap, Representation, ResourceIdentifier, Conditions, ResourceStore } from '@solid/community-server';
+/**
+ * 资源变更事件类型
+ */
+export type ResourceChangeAction = 'create' | 'update' | 'delete';
+/**
+ * 资源变更事件
+ */
+export interface ResourceChangeEvent {
+    /** 资源路径 */
+    path: string;
+    /** 变更类型 */
+    action: ResourceChangeAction;
+    /** 是否为容器 */
+    isContainer: boolean;
+    /** 变更时间戳 */
+    timestamp: number;
+}
+/**
+ * 资源变更监听器接口
+ */
+export interface ResourceChangeListener {
+    /**
+     * 处理资源变更事件
+     * @param event 变更事件
+     */
+    onResourceChanged(event: ResourceChangeEvent): Promise<void>;
+}
+export interface ObservableResourceStoreOptions {
+    /** 资源变更监听器列表 */
+    listeners?: ResourceChangeListener[];
+}
+/**
+ * ObservableResourceStore - 在资源变更时发出事件
+ *
+ * 使用方式：
+ * 1. 作为 Store 链的包装层
+ * 2. 注册 listeners 处理变更事件
+ * 3. 事件异步处理，不阻塞主流程
+ */
+export declare class ObservableResourceStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly emitter;
+    private readonly listeners;
+    constructor(source: T, options?: ObservableResourceStoreOptions);
+    /**
+     * 添加监听器
+     */
+    addListener(listener: ResourceChangeListener): void;
+    /**
+     * 移除监听器
+     */
+    removeListener(listener: ResourceChangeListener): void;
+    /**
+     * 添加资源（创建新资源）
+     */
+    addResource(container: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap>;
+    /**
+     * 设置资源（创建或更新）
+     */
+    setRepresentation(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap>;
+    /**
+     * 删除资源
+     */
+    deleteResource(identifier: ResourceIdentifier, conditions?: Conditions): Promise<ChangeMap>;
+    /**
+     * 修改资源（PATCH）
+     */
+    modifyResource(identifier: ResourceIdentifier, patch: Representation, conditions?: Conditions): Promise<ChangeMap>;
+    /**
+     * 发出资源变更事件
+     */
+    private emitChange;
+    /**
+     * 通知所有监听器
+     */
+    private notifyListeners;
+    /**
+     * 检查资源是否存在
+     */
+    private resourceExists;
+}

package/dist/storage/ObservableResourceStore.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * ObservableResourceStore - 可观察的资源存储包装器
+ *
+ * 在资源变更时发出事件，供订阅者（如 UsageTracker、VectorIndexer）处理。
+ * 采用事件驱动模式，解耦存储操作与副作用逻辑。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservableResourceStore = void 0;
+const node_events_1 = require("node:events");
+const community_server_1 = require("@solid/community-server");
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * ObservableResourceStore - 在资源变更时发出事件
+ *
+ * 使用方式：
+ * 1. 作为 Store 链的包装层
+ * 2. 注册 listeners 处理变更事件
+ * 3. 事件异步处理，不阻塞主流程
+ */
+class ObservableResourceStore extends community_server_1.PassthroughStore {
+    constructor(source, options = {}) {
+        super(source);
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.emitter = new node_events_1.EventEmitter();
+        this.listeners = options.listeners ?? [];
+        // 注册内部事件处理
+        this.emitter.on('resource:changed', (event) => {
+            this.notifyListeners(event);
+        });
+    }
+    /**
+     * 添加监听器
+     */
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * 移除监听器
+     */
+    removeListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index !== -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * 添加资源（创建新资源）
+     */
+    async addResource(container, representation, conditions) {
+        const change = await super.addResource(container, representation, conditions);
+        // 从 ChangeMap 中获取新创建的资源路径
+        for (const [identifier] of change) {
+            this.emitChange(identifier.path, 'create');
+        }
+        return change;
+    }
+    /**
+     * 设置资源（创建或更新）
+     */
+    async setRepresentation(identifier, representation, conditions) {
+        // 检查资源是否已存在
+        const exists = await this.resourceExists(identifier);
+        const action = exists ? 'update' : 'create';
+        const change = await super.setRepresentation(identifier, representation, conditions);
+        this.emitChange(identifier.path, action);
+        return change;
+    }
+    /**
+     * 删除资源
+     */
+    async deleteResource(identifier, conditions) {
+        const change = await super.deleteResource(identifier, conditions);
+        this.emitChange(identifier.path, 'delete');
+        return change;
+    }
+    /**
+     * 修改资源（PATCH）
+     */
+    async modifyResource(identifier, patch, conditions) {
+        const change = await super.modifyResource(identifier, patch, conditions);
+        this.emitChange(identifier.path, 'update');
+        return change;
+    }
+    /**
+     * 发出资源变更事件
+     */
+    emitChange(path, action) {
+        const event = {
+            path,
+            action,
+            isContainer: path.endsWith('/'),
+            timestamp: Date.now(),
+        };
+        this.logger.debug(`Resource ${action}: ${path}`);
+        // 异步发出事件，不阻塞主流程
+        setImmediate(() => {
+            this.emitter.emit('resource:changed', event);
+        });
+    }
+    /**
+     * 通知所有监听器
+     */
+    notifyListeners(event) {
+        for (const listener of this.listeners) {
+            listener.onResourceChanged(event).catch((error) => {
+                this.logger.error(`Listener error for ${event.path}: ${error}`);
+            });
+        }
+    }
+    /**
+     * 检查资源是否存在
+     */
+    async resourceExists(identifier) {
+        try {
+            await this.source.getRepresentation(identifier, {});
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.ObservableResourceStore = ObservableResourceStore;
+//# sourceMappingURL=ObservableResourceStore.js.map

package/dist/storage/ObservableResourceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableResourceStore.js","sourceRoot":"","sources":["../../src/storage/ObservableResourceStore.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ObservableResourceStore - 可观察的资源存储包装器\n *\n * 在资源变更时发出事件，供订阅者（如 UsageTracker、VectorIndexer）处理。\n * 采用事件驱动模式，解耦存储操作与副作用逻辑。\n */\n\nimport { EventEmitter } from 'node:events';\nimport { PassthroughStore } from '@solid/community-server';\nimport type {\n  ChangeMap,\n  Representation,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Conditions,\n  ResourceStore,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\n/**\n * 资源变更事件类型\n */\nexport type ResourceChangeAction = 'create' | 'update' | 'delete';\n\n/**\n * 资源变更事件\n */\nexport interface ResourceChangeEvent {\n  /** 资源路径 */\n  path: string;\n  /** 变更类型 */\n  action: ResourceChangeAction;\n  /** 是否为容器 */\n  isContainer: boolean;\n  /** 变更时间戳 */\n  timestamp: number;\n}\n\n/**\n * 资源变更监听器接口\n */\nexport interface ResourceChangeListener {\n  /**\n   * 处理资源变更事件\n   * @param event 变更事件\n   */\n  onResourceChanged(event: ResourceChangeEvent): Promise<void>;\n}\n\nexport interface ObservableResourceStoreOptions {\n  /** 资源变更监听器列表 */\n  listeners?: ResourceChangeListener[];\n}\n\n/**\n * ObservableResourceStore - 在资源变更时发出事件\n *\n * 使用方式：\n * 1. 作为 Store 链的包装层\n * 2. 注册 listeners 处理变更事件\n * 3. 事件异步处理，不阻塞主流程\n */\nexport class ObservableResourceStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  protected readonly logger = getLoggerFor(this);\n  private readonly emitter = new EventEmitter();\n  private readonly listeners: ResourceChangeListener[];\n\n  public constructor(source: T, options: ObservableResourceStoreOptions = {}) {\n    super(source);\n    this.listeners = options.listeners ?? [];\n\n    // 注册内部事件处理\n    this.emitter.on('resource:changed', (event: ResourceChangeEvent) => {\n      this.notifyListeners(event);\n    });\n  }\n\n  /**\n   * 添加监听器\n   */\n  public addListener(listener: ResourceChangeListener): void {\n    this.listeners.push(listener);\n  }\n\n  /**\n   * 移除监听器\n   */\n  public removeListener(listener: ResourceChangeListener): void {\n    const index = this.listeners.indexOf(listener);\n    if (index !== -1) {\n      this.listeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * 添加资源（创建新资源）\n   */\n  public override async addResource(\n    container: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.addResource(container, representation, conditions);\n\n    // 从 ChangeMap 中获取新创建的资源路径\n    for (const [identifier] of change) {\n      this.emitChange(identifier.path, 'create');\n    }\n\n    return change;\n  }\n\n  /**\n   * 设置资源（创建或更新）\n   */\n  public override async setRepresentation(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    // 检查资源是否已存在\n    const exists = await this.resourceExists(identifier);\n    const action: ResourceChangeAction = exists ? 'update' : 'create';\n\n    const change = await super.setRepresentation(identifier, representation, conditions);\n\n    this.emitChange(identifier.path, action);\n\n    return change;\n  }\n\n  /**\n   * 删除资源\n   */\n  public override async deleteResource(\n    identifier: ResourceIdentifier,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.deleteResource(identifier, conditions);\n\n    this.emitChange(identifier.path, 'delete');\n\n    return change;\n  }\n\n  /**\n   * 修改资源（PATCH）\n   */\n  public override async modifyResource(\n    identifier: ResourceIdentifier,\n    patch: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.modifyResource(identifier, patch, conditions);\n\n    this.emitChange(identifier.path, 'update');\n\n    return change;\n  }\n\n  /**\n   * 发出资源变更事件\n   */\n  private emitChange(path: string, action: ResourceChangeAction): void {\n    const event: ResourceChangeEvent = {\n      path,\n      action,\n      isContainer: path.endsWith('/'),\n      timestamp: Date.now(),\n    };\n\n    this.logger.debug(`Resource ${action}: ${path}`);\n\n    // 异步发出事件，不阻塞主流程\n    setImmediate(() => {\n      this.emitter.emit('resource:changed', event);\n    });\n  }\n\n  /**\n   * 通知所有监听器\n   */\n  private notifyListeners(event: ResourceChangeEvent): void {\n    for (const listener of this.listeners) {\n      listener.onResourceChanged(event).catch((error) => {\n        this.logger.error(`Listener error for ${event.path}: ${error}`);\n      });\n    }\n  }\n\n  /**\n   * 检查资源是否存在\n   */\n  private async resourceExists(identifier: ResourceIdentifier): Promise<boolean> {\n    try {\n      await this.source.getRepresentation(identifier, {} as RepresentationPreferences);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"]}

package/dist/storage/RepresentationPartialConvertingStore.d.ts

@@ -0,0 +1,22 @@
+import { PassthroughStore, AuxiliaryStrategy, ResourceStore, RepresentationConverter, RepresentationPreferences, ResourceIdentifier, Representation, Conditions, ChangeMap } from "@solid/community-server";
+interface RepresentationPartialConvertingStoreOptions {
+    outConverter?: RepresentationConverter;
+    inConverter?: RepresentationConverter;
+    inPreferences?: RepresentationPreferences;
+}
+/**
+ * A store that converts representations based on their content type.
+ */
+export declare class RepresentationPartialConvertingStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly metadataStrategy;
+    private readonly inConverter;
+    private readonly outConverter;
+    private readonly inPreferences;
+    constructor(source: T, metadataStrategy: AuxiliaryStrategy, options: RepresentationPartialConvertingStoreOptions);
+    private shouldConvert;
+    getRepresentation(identifier: ResourceIdentifier, preferences: RepresentationPreferences, conditions?: Conditions): Promise<Representation>;
+    addResource(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap>;
+    setRepresentation(identifier: ResourceIdentifier, representation: Representation, conditions?: Conditions): Promise<ChangeMap>;
+}
+export {};

package/dist/storage/RepresentationPartialConvertingStore.js

@@ -0,0 +1,94 @@
+"use strict";
+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");
+/**
+ * A store that converts representations based on their content type.
+ */
+class RepresentationPartialConvertingStore extends community_server_1.PassthroughStore {
+    constructor(source, metadataStrategy, options) {
+        super(source);
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.metadataStrategy = metadataStrategy;
+        this.inConverter = options.inConverter ?? new community_server_1.PassthroughConverter();
+        this.outConverter = options.outConverter ?? new community_server_1.PassthroughConverter();
+        this.inPreferences = options.inPreferences ?? {};
+        const inConverterClass = this.inConverter.constructor.name;
+        const outConverterClass = this.outConverter.constructor.name;
+        this.logger.debug(`Initializing with inConverter: ${inConverterClass}, 
+      outConverter: ${outConverterClass}, 
+      inPreferences: ${JSON.stringify(this.inPreferences)}`);
+    }
+    async shouldConvert(identifier, representation, preferences) {
+        if (representation.metadata.contentType === undefined) {
+            return false;
+        }
+        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)) {
+            this.logger.debug(`Not converting ${identifier.path}: ${contentType} is not in RDF whitelist`);
+            return false;
+        }
+        try {
+            await this.inConverter.canHandle({ identifier, representation, preferences });
+            this.logger.debug(`Converting ${identifier.path}: ${contentType} to ${preferencesType}`);
+            return true;
+        }
+        catch (error) {
+            this.logger.debug(`Not converting ${identifier.path}: ${contentType} to ${preferencesType}. Error: ${error}`);
+            return false;
+        }
+    }
+    async getRepresentation(identifier, preferences, conditions) {
+        let representation = await super.getRepresentation(identifier, preferences, conditions);
+        if (await this.shouldConvert(identifier, representation, preferences)) {
+            representation = await this.outConverter.handleSafe({ identifier, representation, preferences });
+        }
+        return representation;
+    }
+    async addResource(identifier, representation, conditions) {
+        // In case of containers, no content-type is required and the representation is not used.
+        try {
+            if (await this.shouldConvert(identifier, representation, this.inPreferences)) {
+                // We can potentially run into problems here if we convert a turtle document where the base IRI is required,
+                // since we don't know the resource IRI yet at this point.
+                representation = await this.inConverter.handleSafe({ identifier, representation, preferences: this.inPreferences });
+            }
+        }
+        catch (error) {
+            this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return this.source.addResource(identifier, representation, conditions);
+    }
+    async setRepresentation(identifier, representation, conditions) {
+        try {
+            // When it is a metadata resource, convert it to Quads as those are expected in the later stores
+            if (this.metadataStrategy.isAuxiliaryIdentifier(identifier)) {
+                this.logger.debug(`Converting metadata resource ${identifier.path} to ${community_server_1.INTERNAL_QUADS}`);
+                representation = await this.inConverter.handleSafe({ identifier, representation, preferences: { type: { [community_server_1.INTERNAL_QUADS]: 1 } } });
+            }
+            else if (await this.shouldConvert(identifier, representation, this.inPreferences)) {
+                representation = await this.inConverter.handleSafe({ identifier, representation, preferences: this.inPreferences });
+            }
+        }
+        catch (error) {
+            this.logger.warn(`Conversion skipped for ${identifier.path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return this.source.setRepresentation(identifier, representation, conditions);
+    }
+}
+exports.RepresentationPartialConvertingStore = RepresentationPartialConvertingStore;
+//# sourceMappingURL=RepresentationPartialConvertingStore.js.map

package/dist/storage/RepresentationPartialConvertingStore.js.map

@@ -0,0 +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"]}