@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/accessors/MinioDataAccessor.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinioDataAccessor = void 0;
+const minio_1 = require("minio");
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+class MinioDataAccessor {
+    constructor(resourceMapper, accessKey, secretKey, endpoint, bucketName) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.resourceMapper = resourceMapper;
+        // Parse endpoint - supports both URL format (http://host:port) and simple format (host:port)
+        let endPoint;
+        let port;
+        let useSSL = false;
+        if (endpoint.startsWith('http://') || endpoint.startsWith('https://')) {
+            const url = new URL(endpoint);
+            endPoint = url.hostname;
+            port = url.port ? parseInt(url.port, 10) : undefined;
+            useSSL = url.protocol === 'https:';
+        }
+        else {
+            const parts = endpoint.split(':');
+            endPoint = parts[0];
+            port = parts[1] ? parseInt(parts[1], 10) : undefined;
+        }
+        this.client = new minio_1.Client({
+            accessKey,
+            secretKey,
+            endPoint,
+            port,
+            useSSL,
+        });
+        this.bucketName = bucketName;
+        this.logger.info(`MinioDataAccessor initialized with endpoint: ${endPoint}:${port} (SSL: ${useSSL})`);
+    }
+    /**
+     * Should throw a NotImplementedHttpError if the DataAccessor does not support storing the given Representation.
+     *
+     * @param representation - Incoming Representation.
+     *
+     * @throws BadRequestHttpError
+     * If it does not support the incoming data.
+     */
+    async canHandle(representation) {
+        if (!representation.binary) {
+            throw new community_server_1.UnsupportedMediaTypeHttpError('Only binary data is supported.');
+        }
+    }
+    /**
+     * Returns a data stream stored for the given identifier.
+     * It can be assumed that the incoming identifier will always correspond to a document.
+     *
+     * @param identifier - Identifier for which the data is requested.
+     */
+    async getData(identifier) {
+        const url = new URL(identifier.path);
+        const stream = await this.client.getObject(this.bucketName, url.pathname);
+        return (0, community_server_1.guardStream)(stream);
+    }
+    /**
+     * Returns the metadata corresponding to the identifier.
+     * If possible, it is suggested to add a `posix:size` triple to the metadata indicating the binary size.
+     * This is necessary for range requests.
+     *
+     * @param identifier - Identifier for which the metadata is requested.
+     */
+    async getMetadata(identifier) {
+        const url = new URL(identifier.path);
+        const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);
+        const isDirectory = identifier.path.endsWith('/');
+        const objectName = isDirectory ? `${url.pathname}/.container` : url.pathname;
+        let stats;
+        try {
+            stats = await this.client.statObject(this.bucketName, objectName);
+        }
+        catch (error) {
+            throw new community_server_1.NotFoundHttpError();
+        }
+        if (!(0, community_server_1.isContainerIdentifier)(identifier) && !isDirectory) {
+            return this.getFileMetadata(link, stats);
+        }
+        if ((0, community_server_1.isContainerIdentifier)(identifier) && isDirectory) {
+            return this.getDirectoryMetadata(link, stats);
+        }
+        throw new community_server_1.NotFoundHttpError();
+    }
+    /**
+     * Returns metadata for all resources in the requested container.
+     * This should not be all metadata of those resources (but it can be),
+     * but instead the main metadata you want to show in situations
+     * where all these resources are presented simultaneously.
+     * Generally this would be metadata that is present for all of these resources,
+     * such as resource type or last modified date.
+     *
+     * It can be safely assumed that the incoming identifier will always correspond to a container.
+     *
+     * @param identifier - Identifier of the parent container.
+     */
+    async *getChildren(identifier) {
+        const url = new URL(identifier.path);
+        const objects = this.client.listObjectsV2(this.bucketName, url.pathname);
+        for await (const object of objects) {
+            const metadata = await this.getMetadata(object);
+            yield metadata;
+        }
+    }
+    /**
+     * Writes data and metadata for a document.
+     * If any data and/or metadata exist for the given identifier, it should be overwritten.
+     *
+     * @param identifier - Identifier of the resource.
+     * @param data - Data to store.
+     * @param metadata - Metadata to store.
+     */
+    async writeDocument(identifier, data, metadata) {
+        const url = new URL(identifier.path);
+        const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);
+        const itemMetadata = this.encodeMetadata(link, metadata);
+        try {
+            await this.client.putObject(this.bucketName, url.pathname, data, metadata.contentLength, itemMetadata || undefined);
+        }
+        catch (error) {
+            this.logger.error(`Error writing document: ${identifier.path} ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Writes metadata for a container.
+     * If the container does not exist yet it should be created,
+     * if it does its metadata should be overwritten, except for the containment triples.
+     *
+     * @param identifier - Identifier of the container.
+     * @param metadata - Metadata to store.
+     */
+    async writeContainer(identifier, metadata) {
+        const url = new URL(identifier.path);
+        const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);
+        await this.client.putObject(this.bucketName, `${url.pathname}/.container`, Buffer.from(''), metadata.contentLength, this.encodeMetadata(link, metadata) || undefined);
+    }
+    /**
+     * Writes metadata for a resource.
+     * It can safely be assumed that the subject resource already exists.
+     *
+     * @param identifier - Identifier of the subject resource.
+     * @param metadata - Metadata to store.
+     */
+    async writeMetadata(identifier, metadata) {
+        throw new Error('Minio does not support writing metadata for a resource.');
+    }
+    /**
+     * Deletes the resource and its corresponding metadata.
+     *
+     * Solid, §5.4: "When a contained resource is deleted, the server MUST also remove the corresponding containment
+     * triple, which has the effect of removing the deleted resource from the containing container."
+     * https://solid.github.io/specification/protocol#deleting-resources
+     *
+     * @param identifier - Resource to delete.
+     */
+    async deleteResource(identifier) {
+        const link = new URL(identifier.path);
+        await this.client.removeObject(this.bucketName, link.pathname);
+    }
+    /**
+     * Reads and generates all metadata relevant for the given file,
+     * ingesting it into a RepresentationMetadata object.
+     *
+     * @param link - Path related metadata.
+     * @param stats - Stats object of the corresponding file.
+     */
+    async getFileMetadata(link, stats) {
+        const metadata = await this.getBaseMetadata(link, stats, false);
+        // If the resource is using an unsupported contentType, the original contentType was written to the metadata file.
+        // As a result, we should only set the contentType derived from the file path,
+        // when no previous metadata entry for contentType is present.
+        if (typeof metadata.contentType === 'undefined') {
+            metadata.set(community_server_1.CONTENT_TYPE_TERM, link.contentType);
+        }
+        return metadata;
+    }
+    /**
+     * Reads and generates all metadata relevant for the given directory,
+     * ingesting it into a RepresentationMetadata object.
+     *
+     * @param link - Path related metadata.
+     * @param stats - Stats object of the corresponding directory.
+     */
+    async getDirectoryMetadata(link, stats) {
+        return this.getBaseMetadata(link, stats, true);
+    }
+    /**
+     * Generates metadata relevant for any resources stored by this accessor.
+     *
+     * @param link - Path related metadata.
+     * @param stats - Stats objects of the corresponding directory.
+     * @param isContainer - If the path points to a container (directory) or not.
+     */
+    async getBaseMetadata(link, stats, isContainer) {
+        const metadata = this.decodeMetadata(link, stats.metaData);
+        (0, community_server_1.addResourceMetadata)(metadata, isContainer);
+        this.addPosixMetadata(metadata, stats, isContainer);
+        return metadata;
+    }
+    /**
+     * Helper function to add file system related metadata.
+     *
+     * @param metadata - metadata object to add to
+     * @param stats - Stats of the file/directory corresponding to the resource.
+     */
+    addPosixMetadata(metadata, stats, isDirectory) {
+        (0, community_server_1.updateModifiedDate)(metadata, stats.lastModified);
+        metadata.add(community_server_1.POSIX.terms.mtime, (0, community_server_1.toLiteral)(Math.floor(stats.lastModified.getTime() / 1000), community_server_1.XSD.terms.integer), community_server_1.SOLID_META.terms.ResponseMetadata);
+        if (!isDirectory) {
+            metadata.add(community_server_1.POSIX.terms.size, (0, community_server_1.toLiteral)(stats.size, community_server_1.XSD.terms.integer), community_server_1.SOLID_META.terms.ResponseMetadata);
+        }
+    }
+    /**
+     * encode the metadata of the resource to string.
+     *
+     * @param link - Path related metadata of the resource.
+     * @param metadata - Metadata to write.
+     *
+     * @returns string of metadata.
+     */
+    encodeMetadata(link, metadata) {
+        // These are stored by file system conventions
+        metadata.remove(community_server_1.RDF.terms.type, community_server_1.LDP.terms.Resource);
+        metadata.remove(community_server_1.RDF.terms.type, community_server_1.LDP.terms.Container);
+        metadata.remove(community_server_1.RDF.terms.type, community_server_1.LDP.terms.BasicContainer);
+        metadata.removeAll(community_server_1.DC.terms.modified);
+        // When writing metadata for a document, only remove the content-type when dealing with a supported media type.
+        // A media type is supported if the FileIdentifierMapper can correctly store it.
+        // This allows restoring the appropriate content-type on data read (see getFileMetadata).
+        if ((0, community_server_1.isContainerPath)(link.filePath) || typeof metadata.contentType !== 'undefined') {
+            metadata.removeAll(community_server_1.CONTENT_TYPE_TERM);
+        }
+        const contentTypeObject = metadata.contentTypeObject;
+        if (contentTypeObject === undefined
+            || Object.keys(contentTypeObject.parameters).length === 0) {
+            return null;
+        }
+        // Write metadata to file if there are quads remaining
+        return contentTypeObject.parameters;
+    }
+    decodeMetadata(link, metadata) {
+        return new community_server_1.RepresentationMetadata(link.identifier, metadata);
+    }
+}
+exports.MinioDataAccessor = MinioDataAccessor;
+//# sourceMappingURL=MinioDataAccessor.js.map

package/dist/storage/accessors/MinioDataAccessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MinioDataAccessor.js","sourceRoot":"","sources":["../../../src/storage/accessors/MinioDataAccessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client, BucketItemStat } from 'minio';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { DataAccessor } from '@solid/community-server';\nimport type { Readable } from 'node:stream';\nimport { DataFactory } from 'n3';\nimport {\n  RepresentationMetadata,\n  \n  NotFoundHttpError,\n  guardStream,\n  isContainerIdentifier,\n  isContainerPath,\n  joinFilePath,\n  UnsupportedMediaTypeHttpError,\n  CONTENT_TYPE_TERM,\n  DC,\n  IANA,\n  LDP,\n  POSIX,\n  RDF,\n  SOLID_META,\n  XSD,\n  parseQuads,\n  serializeQuads,\n  addResourceMetadata,\n  updateModifiedDate,\n  toLiteral,\n  toNamedTerm,\n} from '@solid/community-server';\nimport type { Guarded } from '@solid/community-server';\nimport type { FileIdentifierMapper, ResourceLink } from '@solid/community-server';\nimport type { \n  ResourceIdentifier,\n  Representation,\n  MetadataRecord\n} from '@solid/community-server';\n\nexport class MinioDataAccessor implements DataAccessor {\n  protected readonly logger = getLoggerFor(this);\n  protected readonly resourceMapper: FileIdentifierMapper;\n  private readonly client: Client;\n  private readonly bucketName: string;\n\n  public constructor(\n    resourceMapper: FileIdentifierMapper,\n    accessKey: string,\n    secretKey: string,\n    endpoint: string,\n    bucketName: string,\n  ) {\n    this.resourceMapper = resourceMapper;\n\n    // Parse endpoint - supports both URL format (http://host:port) and simple format (host:port)\n    let endPoint: string;\n    let port: number | undefined;\n    let useSSL = false;\n\n    if (endpoint.startsWith('http://') || endpoint.startsWith('https://')) {\n      const url = new URL(endpoint);\n      endPoint = url.hostname;\n      port = url.port ? parseInt(url.port, 10) : undefined;\n      useSSL = url.protocol === 'https:';\n    } else {\n      const parts = endpoint.split(':');\n      endPoint = parts[0];\n      port = parts[1] ? parseInt(parts[1], 10) : undefined;\n    }\n\n    this.client = new Client({\n      accessKey,\n      secretKey,\n      endPoint,\n      port,\n      useSSL,\n    });\n    this.bucketName = bucketName;\n    this.logger.info(`MinioDataAccessor initialized with endpoint: ${endPoint}:${port} (SSL: ${useSSL})`)\n  }\n\n  /**\n   * Should throw a NotImplementedHttpError if the DataAccessor does not support storing the given Representation.\n   *\n   * @param representation - Incoming Representation.\n   *\n   * @throws BadRequestHttpError\n   * If it does not support the incoming data.\n   */\n  public async canHandle(representation: Representation): Promise<void> {\n    if (!representation.binary) {\n      throw new UnsupportedMediaTypeHttpError('Only binary data is supported.');\n    }\n  }\n\n  /**\n   * Returns a data stream stored for the given identifier.\n   * It can be assumed that the incoming identifier will always correspond to a document.\n   *\n   * @param identifier - Identifier for which the data is requested.\n   */\n  public async getData(identifier: ResourceIdentifier): Promise<Guarded<Readable>> {\n    const url = new URL(identifier.path)\n    const stream = await this.client.getObject(this.bucketName, url.pathname);\n    return guardStream(stream);\n  }\n\n  /**\n   * Returns the metadata corresponding to the identifier.\n   * If possible, it is suggested to add a `posix:size` triple to the metadata indicating the binary size.\n   * This is necessary for range requests.\n   *\n   * @param identifier - Identifier for which the metadata is requested.\n   */\n  public async getMetadata(identifier: ResourceIdentifier): Promise<RepresentationMetadata> {\n    const url = new URL(identifier.path)\n    const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);\n    const isDirectory = identifier.path.endsWith('/');\n    const objectName = isDirectory ? `${url.pathname}/.container` : url.pathname;\n    let stats: BucketItemStat;\n    try {\n      stats = await this.client.statObject(this.bucketName, objectName);\n    } catch (error) {\n      throw new NotFoundHttpError();\n    }\n    if (!isContainerIdentifier(identifier) && !isDirectory) {\n      return this.getFileMetadata(link, stats);\n    }\n    if (isContainerIdentifier(identifier) && isDirectory) {\n      return this.getDirectoryMetadata(link, stats);\n    }\n    throw new NotFoundHttpError();\n  }\n\n  /**\n   * Returns metadata for all resources in the requested container.\n   * This should not be all metadata of those resources (but it can be),\n   * but instead the main metadata you want to show in situations\n   * where all these resources are presented simultaneously.\n   * Generally this would be metadata that is present for all of these resources,\n   * such as resource type or last modified date.\n   *\n   * It can be safely assumed that the incoming identifier will always correspond to a container.\n   *\n   * @param identifier - Identifier of the parent container.\n   */\n  public async* getChildren(identifier: ResourceIdentifier): AsyncIterableIterator<RepresentationMetadata> {\n    const url = new URL(identifier.path)\n    const objects = this.client.listObjectsV2(this.bucketName, url.pathname);\n    for await (const object of objects) {\n      const metadata = await this.getMetadata(object);\n      yield metadata;\n    }\n  }\n\n  /**\n   * Writes data and metadata for a document.\n   * If any data and/or metadata exist for the given identifier, it should be overwritten.\n   *\n   * @param identifier - Identifier of the resource.\n   * @param data - Data to store.\n   * @param metadata - Metadata to store.\n   */\n  public async writeDocument(identifier: ResourceIdentifier, data: Guarded<Readable>, metadata: RepresentationMetadata): Promise<void> {\n    const url = new URL(identifier.path);\n    const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);\n    const itemMetadata = this.encodeMetadata(link, metadata);\n    try {\n      await this.client.putObject(\n        this.bucketName,\n        url.pathname,\n        data,\n        metadata.contentLength,\n        itemMetadata || undefined,\n      );\n    } catch (error) {\n      this.logger.error(`Error writing document: ${identifier.path} ${error}`)\n      throw error;\n    }\n  }\n\n  /**\n   * Writes metadata for a container.\n   * If the container does not exist yet it should be created,\n   * if it does its metadata should be overwritten, except for the containment triples.\n   *\n   * @param identifier - Identifier of the container.\n   * @param metadata - Metadata to store.\n   */\n  public async writeContainer(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void> {\n    const url = new URL(identifier.path)\n    const link = await this.resourceMapper.mapUrlToFilePath(identifier, false);\n    await this.client.putObject(\n      this.bucketName,\n      `${url.pathname}/.container`,\n      Buffer.from(''),\n      metadata.contentLength,\n      this.encodeMetadata(link, metadata) || undefined,\n    );\n  }\n\n  /**\n   * Writes metadata for a resource.\n   * It can safely be assumed that the subject resource already exists.\n   *\n   * @param identifier - Identifier of the subject resource.\n   * @param metadata - Metadata to store.\n   */\n  public async writeMetadata(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void> {\n    throw new Error('Minio does not support writing metadata for a resource.');\n  }\n\n  /**\n   * Deletes the resource and its corresponding metadata.\n   *\n   * Solid, §5.4: \"When a contained resource is deleted, the server MUST also remove the corresponding containment\n   * triple, which has the effect of removing the deleted resource from the containing container.\"\n   * https://solid.github.io/specification/protocol#deleting-resources\n   *\n   * @param identifier - Resource to delete.\n   */\n  public async deleteResource(identifier: ResourceIdentifier): Promise<void> {\n    const link = new URL(identifier.path)\n    await this.client.removeObject(this.bucketName, link.pathname);\n  }\n\n  /**\n   * Reads and generates all metadata relevant for the given file,\n   * ingesting it into a RepresentationMetadata object.\n   *\n   * @param link - Path related metadata.\n   * @param stats - Stats object of the corresponding file.\n   */\n  private async getFileMetadata(link: ResourceLink, stats: BucketItemStat): Promise<RepresentationMetadata> {\n    const metadata = await this.getBaseMetadata(link, stats, false);\n      // If the resource is using an unsupported contentType, the original contentType was written to the metadata file.\n      // As a result, we should only set the contentType derived from the file path,\n      // when no previous metadata entry for contentType is present.\n    if (typeof metadata.contentType === 'undefined') {\n      metadata.set(CONTENT_TYPE_TERM, link.contentType);\n    }\n    return metadata;\n  }\n\n  /**\n   * Reads and generates all metadata relevant for the given directory,\n   * ingesting it into a RepresentationMetadata object.\n   *\n   * @param link - Path related metadata.\n   * @param stats - Stats object of the corresponding directory.\n   */\n  private async getDirectoryMetadata(link: ResourceLink, stats: BucketItemStat): Promise<RepresentationMetadata> {\n    return this.getBaseMetadata(link, stats, true);\n  }\n  \n  /**\n   * Generates metadata relevant for any resources stored by this accessor.\n   *\n   * @param link - Path related metadata.\n   * @param stats - Stats objects of the corresponding directory.\n   * @param isContainer - If the path points to a container (directory) or not.\n   */\n  private async getBaseMetadata(link: ResourceLink, stats: BucketItemStat, isContainer: boolean): Promise<RepresentationMetadata> {\n    const metadata = this.decodeMetadata(link, stats.metaData);\n    addResourceMetadata(metadata, isContainer);\n    this.addPosixMetadata(metadata, stats, isContainer);\n    return metadata;\n  }\n  \n  /**\n   * Helper function to add file system related metadata.\n   *\n   * @param metadata - metadata object to add to\n   * @param stats - Stats of the file/directory corresponding to the resource.\n   */\n  private addPosixMetadata(metadata: RepresentationMetadata, stats: BucketItemStat, isDirectory: boolean): void {\n    updateModifiedDate(metadata, stats.lastModified);\n    metadata.add(\n      POSIX.terms.mtime,\n      toLiteral(Math.floor(stats.lastModified.getTime() / 1000), XSD.terms.integer),\n      SOLID_META.terms.ResponseMetadata,\n    );\n    if (!isDirectory) {\n      metadata.add(\n        POSIX.terms.size,\n        toLiteral(stats.size, XSD.terms.integer),\n        SOLID_META.terms.ResponseMetadata,\n      );\n    }\n  }\n\n  /**\n   * encode the metadata of the resource to string.\n   *\n   * @param link - Path related metadata of the resource.\n   * @param metadata - Metadata to write.\n   *\n   * @returns string of metadata.\n   */\n  protected encodeMetadata(link: ResourceLink, metadata: RepresentationMetadata): object | null {\n    // These are stored by file system conventions\n    metadata.remove(RDF.terms.type, LDP.terms.Resource);\n    metadata.remove(RDF.terms.type, LDP.terms.Container);\n    metadata.remove(RDF.terms.type, LDP.terms.BasicContainer);\n    metadata.removeAll(DC.terms.modified);\n    // When writing metadata for a document, only remove the content-type when dealing with a supported media type.\n    // A media type is supported if the FileIdentifierMapper can correctly store it.\n    // This allows restoring the appropriate content-type on data read (see getFileMetadata).\n    if (isContainerPath(link.filePath) || typeof metadata.contentType !== 'undefined') {\n      metadata.removeAll(CONTENT_TYPE_TERM);\n    }\n    const contentTypeObject = metadata.contentTypeObject\n    if (contentTypeObject === undefined\n      || Object.keys(contentTypeObject.parameters).length === 0) {\n      return null;\n    }\n    // Write metadata to file if there are quads remaining\n    return contentTypeObject.parameters;\n  }\n\n  protected decodeMetadata(link: ResourceLink, metadata: MetadataRecord): RepresentationMetadata {\n    return new RepresentationMetadata(link.identifier, metadata);\n  }\n}\n"]}

package/dist/storage/accessors/MinioDataAccessor.jsonld

@@ -0,0 +1,138 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor",
+      "@type": "Class",
+      "requireElement": "MinioDataAccessor",
+      "extends": [
+        "css:dist/storage/accessors/DataAccessor.jsonld#DataAccessor"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_accessKey",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_secretKey",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_endpoint",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_bucketName",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_resourceMapper",
+          "range": "css:dist/storage/mapping/FileIdentifierMapper.jsonld#FileIdentifierMapper"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_resourceMapper",
+          "memberFieldName": "resourceMapper",
+          "range": "css:dist/storage/mapping/FileIdentifierMapper.jsonld#FileIdentifierMapper"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_client",
+          "memberFieldName": "client"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_bucketName",
+          "memberFieldName": "bucketName"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getData",
+          "memberFieldName": "getData"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getMetadata",
+          "memberFieldName": "getMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getChildren",
+          "memberFieldName": "getChildren"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_writeDocument",
+          "memberFieldName": "writeDocument"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_writeContainer",
+          "memberFieldName": "writeContainer"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_writeMetadata",
+          "memberFieldName": "writeMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_deleteResource",
+          "memberFieldName": "deleteResource"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getFileMetadata",
+          "memberFieldName": "getFileMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getDirectoryMetadata",
+          "memberFieldName": "getDirectoryMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_getBaseMetadata",
+          "memberFieldName": "getBaseMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_addPosixMetadata",
+          "memberFieldName": "addPosixMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_encodeMetadata",
+          "memberFieldName": "encodeMetadata"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor__member_decodeMetadata",
+          "memberFieldName": "decodeMetadata"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_resourceMapper"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_accessKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_secretKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_endpoint"
+        },
+        {
+          "@id": "undefineds:dist/storage/accessors/MinioDataAccessor.jsonld#MinioDataAccessor_bucketName"
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,43 @@
+import type { Readable } from 'stream';
+import { RepresentationMetadata } from '@solid/community-server';
+import type { Representation, ResourceIdentifier, Guarded, DataAccessor } from '@solid/community-server';
+/**
+ * MixDataAccessor - Routes data to appropriate storage based on content type
+ *
+ * - RDF data (internal/quads) -> structuredDataAccessor (Quadstore or QuintStore)
+ * - Other data (binary, text, etc.) -> unstructuredDataAccessor (FileSystem, Minio, etc.)
+ *
+ * This uses composition instead of inheritance, allowing any DataAccessor
+ * to be used as the RDF storage backend.
+ */
+export declare class MixDataAccessor implements DataAccessor {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly structuredDataAccessor;
+    private readonly unstructuredDataAccessor;
+    constructor(structuredDataAccessor: DataAccessor, unstructuredDataAccessor: DataAccessor);
+    /**
+     * This accessor supports all types of data.
+     */
+    canHandle(representation: Representation): Promise<void>;
+    /**
+     * Checks if the given representation is unstructured (non-RDF).
+     */
+    private isUnstructured;
+    getData(identifier: ResourceIdentifier): Promise<Guarded<Readable>>;
+    getMetadata(identifier: ResourceIdentifier): Promise<RepresentationMetadata>;
+    getChildren(identifier: ResourceIdentifier): AsyncIterableIterator<RepresentationMetadata>;
+    writeContainer(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void>;
+    writeDocument(identifier: ResourceIdentifier, data: Guarded<Readable>, metadata: RepresentationMetadata): Promise<void>;
+    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.
+     */
+    executeSparqlUpdate(query: string, baseIri?: string): Promise<void>;
+    /**
+     * Write unstructured document: store data in unstructured accessor,
+     * then save metadata in structured accessor.
+     */
+    private writeUnstructuredDocument;
+}

package/dist/storage/accessors/MixDataAccessor.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MixDataAccessor = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+/**
+ * MixDataAccessor - Routes data to appropriate storage based on content type
+ *
+ * - RDF data (internal/quads) -> structuredDataAccessor (Quadstore or QuintStore)
+ * - Other data (binary, text, etc.) -> unstructuredDataAccessor (FileSystem, Minio, etc.)
+ *
+ * This uses composition instead of inheritance, allowing any DataAccessor
+ * to be used as the RDF storage backend.
+ */
+class MixDataAccessor {
+    constructor(structuredDataAccessor, unstructuredDataAccessor) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.structuredDataAccessor = structuredDataAccessor;
+        this.unstructuredDataAccessor = unstructuredDataAccessor;
+    }
+    /**
+     * This accessor supports all types of data.
+     */
+    async canHandle(representation) {
+        return void 0;
+    }
+    /**
+     * Checks if the given representation is unstructured (non-RDF).
+     */
+    isUnstructured(metadata) {
+        return metadata.contentType !== community_server_1.INTERNAL_QUADS;
+    }
+    async getData(identifier) {
+        const metadata = await this.getMetadata(identifier);
+        if (this.isUnstructured(metadata)) {
+            return await this.unstructuredDataAccessor.getData(identifier);
+        }
+        return await this.structuredDataAccessor.getData(identifier);
+    }
+    async getMetadata(identifier) {
+        // Metadata is always stored in the structured accessor
+        const metadata = await this.structuredDataAccessor.getMetadata(identifier);
+        // For resources without explicit content type, default to RDF
+        // This includes containers (which are always RDF) and documents without contentType
+        if (!metadata.contentType) {
+            metadata.contentType = community_server_1.INTERNAL_QUADS;
+        }
+        return metadata;
+    }
+    async *getChildren(identifier) {
+        // Children metadata is stored in the structured accessor
+        yield* this.structuredDataAccessor.getChildren(identifier);
+    }
+    async writeContainer(identifier, metadata) {
+        // Container metadata goes to structured storage
+        // Also create in unstructured if it needs to store files
+        if (this.isUnstructured(metadata)) {
+            await this.unstructuredDataAccessor.writeContainer(identifier, metadata);
+        }
+        await this.structuredDataAccessor.writeContainer(identifier, metadata);
+    }
+    async writeDocument(identifier, data, metadata) {
+        if (this.isUnstructured(metadata)) {
+            return await this.writeUnstructuredDocument(identifier, data, metadata);
+        }
+        return await this.structuredDataAccessor.writeDocument(identifier, data, metadata);
+    }
+    async writeMetadata(identifier, metadata) {
+        // Metadata always goes to structured storage
+        return await this.structuredDataAccessor.writeMetadata(identifier, metadata);
+    }
+    async deleteResource(identifier) {
+        const metadata = await this.getMetadata(identifier);
+        // Try to delete from unstructured storage if applicable
+        if (this.isUnstructured(metadata)) {
+            try {
+                await this.unstructuredDataAccessor.deleteResource(identifier);
+            }
+            catch (error) {
+                // Ignore file not found errors
+                if (error.code !== 'ENOENT' && error.code !== 'ENOTDIR') {
+                    throw error;
+                }
+            }
+        }
+        // Always delete from structured storage (contains metadata)
+        return await this.structuredDataAccessor.deleteResource(identifier);
+    }
+    /**
+     * Execute SPARQL UPDATE on structured data accessor.
+     * Delegates to the underlying structuredDataAccessor if it supports SPARQL.
+     */
+    async executeSparqlUpdate(query, baseIri) {
+        const accessor = this.structuredDataAccessor;
+        if (typeof accessor.executeSparqlUpdate !== 'function') {
+            throw new Error('Structured data accessor does not support SPARQL UPDATE');
+        }
+        return accessor.executeSparqlUpdate(query, baseIri);
+    }
+    /**
+     * Write unstructured document: store data in unstructured accessor,
+     * then save metadata in structured accessor.
+     */
+    async writeUnstructuredDocument(identifier, data, metadata) {
+        // Write the actual data to unstructured storage
+        await this.unstructuredDataAccessor.writeDocument(identifier, data, metadata);
+        // Get the metadata from unstructured storage (includes size, etc.)
+        let updatedMetadata = await this.unstructuredDataAccessor.getMetadata(identifier);
+        // Filter out invalid quads
+        const removing = [];
+        for (const quad of updatedMetadata.quads()) {
+            if (!/^http/.test(quad.predicate.value)) {
+                removing.push(quad);
+            }
+        }
+        updatedMetadata.removeQuads(removing);
+        // Save metadata to structured storage
+        try {
+            await this.structuredDataAccessor.writeMetadata(identifier, updatedMetadata);
+        }
+        catch (error) {
+            this.logger.error(`Error writing metadata for ${identifier.path}: ${error}`);
+            // Rollback: delete the unstructured data
+            await this.unstructuredDataAccessor.deleteResource(identifier);
+            throw error;
+        }
+    }
+}
+exports.MixDataAccessor = MixDataAccessor;
+//# sourceMappingURL=MixDataAccessor.js.map

package/dist/storage/accessors/MixDataAccessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MixDataAccessor.js","sourceRoot":"","sources":["../../../src/storage/accessors/MixDataAccessor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Readable } from 'stream';\nimport { getLoggerFor } from 'global-logger-factory';\n\nimport type { Quad } from '@rdfjs/types';\nimport { \n  isContainerIdentifier,\n  RepresentationMetadata,\n  INTERNAL_QUADS,\n} from '@solid/community-server';\nimport type {\n  Representation,\n  ResourceIdentifier,\n  Guarded,\n  DataAccessor,\n} from '@solid/community-server';\n\n/**\n * MixDataAccessor - Routes data to appropriate storage based on content type\n * \n * - RDF data (internal/quads) -> structuredDataAccessor (Quadstore or QuintStore)\n * - Other data (binary, text, etc.) -> unstructuredDataAccessor (FileSystem, Minio, etc.)\n * \n * This uses composition instead of inheritance, allowing any DataAccessor\n * to be used as the RDF storage backend.\n */\nexport class MixDataAccessor implements DataAccessor {\n  protected readonly logger = getLoggerFor(this);\n  \n  private readonly structuredDataAccessor: DataAccessor;\n  private readonly unstructuredDataAccessor: DataAccessor;\n\n  constructor(\n    structuredDataAccessor: DataAccessor,\n    unstructuredDataAccessor: DataAccessor,\n  ) {\n    this.structuredDataAccessor = structuredDataAccessor;\n    this.unstructuredDataAccessor = unstructuredDataAccessor;\n  }\n\n  /**\n   * This accessor supports all types of data.\n   */\n  public async canHandle(representation: Representation): Promise<void> {\n    return void 0;\n  }\n\n  /**\n   * Checks if the given representation is unstructured (non-RDF).\n   */\n  private isUnstructured(metadata: RepresentationMetadata): boolean {\n    return metadata.contentType !== INTERNAL_QUADS;\n  }\n\n  public async getData(identifier: ResourceIdentifier): Promise<Guarded<Readable>> {\n    const metadata = await this.getMetadata(identifier);\n    if (this.isUnstructured(metadata)) {\n      return await this.unstructuredDataAccessor.getData(identifier);\n    }\n    return await this.structuredDataAccessor.getData(identifier);\n  }\n\n  public async getMetadata(identifier: ResourceIdentifier): Promise<RepresentationMetadata> {\n    // Metadata is always stored in the structured accessor\n    const metadata = await this.structuredDataAccessor.getMetadata(identifier);\n\n    // For resources without explicit content type, default to RDF\n    // This includes containers (which are always RDF) and documents without contentType\n    if (!metadata.contentType) {\n      metadata.contentType = INTERNAL_QUADS;\n    }\n\n    return metadata;\n  }\n\n  public async* getChildren(identifier: ResourceIdentifier): AsyncIterableIterator<RepresentationMetadata> {\n    // Children metadata is stored in the structured accessor\n    yield* this.structuredDataAccessor.getChildren(identifier);\n  }\n\n  public async writeContainer(\n    identifier: ResourceIdentifier,\n    metadata: RepresentationMetadata,\n  ): Promise<void> {\n    // Container metadata goes to structured storage\n    // Also create in unstructured if it needs to store files\n    if (this.isUnstructured(metadata)) {\n      await this.unstructuredDataAccessor.writeContainer(identifier, metadata);\n    }\n    await this.structuredDataAccessor.writeContainer(identifier, metadata);\n  }\n\n  public async writeDocument(\n    identifier: ResourceIdentifier,\n    data: Guarded<Readable>,\n    metadata: RepresentationMetadata,\n  ): Promise<void> {\n    if (this.isUnstructured(metadata)) {\n      return await this.writeUnstructuredDocument(identifier, data, metadata);\n    }\n    return await this.structuredDataAccessor.writeDocument(identifier, data, metadata);\n  }\n\n  public async writeMetadata(identifier: ResourceIdentifier, metadata: RepresentationMetadata): Promise<void> {\n    // Metadata always goes to structured storage\n    return await this.structuredDataAccessor.writeMetadata(identifier, metadata);\n  }\n\n  public async deleteResource(identifier: ResourceIdentifier): Promise<void> {\n    const metadata = await this.getMetadata(identifier);\n    \n    // Try to delete from unstructured storage if applicable\n    if (this.isUnstructured(metadata)) {\n      try {\n        await this.unstructuredDataAccessor.deleteResource(identifier);\n      } catch (error: any) {\n        // Ignore file not found errors\n        if (error.code !== 'ENOENT' && error.code !== 'ENOTDIR') {\n          throw error;\n        }\n      }\n    }\n    \n    // Always delete from structured storage (contains metadata)\n    return await this.structuredDataAccessor.deleteResource(identifier);\n  }\n\n  /**\n   * Execute SPARQL UPDATE on structured data accessor.\n   * Delegates to the underlying structuredDataAccessor if it supports SPARQL.\n   */\n  public async executeSparqlUpdate(query: string, baseIri?: string): Promise<void> {\n    const accessor = this.structuredDataAccessor as { executeSparqlUpdate?: (query: string, baseIri?: string) => Promise<void> };\n    if (typeof accessor.executeSparqlUpdate !== 'function') {\n      throw new Error('Structured data accessor does not support SPARQL UPDATE');\n    }\n    return accessor.executeSparqlUpdate(query, baseIri);\n  }\n\n  /**\n   * Write unstructured document: store data in unstructured accessor,\n   * then save metadata in structured accessor.\n   */\n  private async writeUnstructuredDocument(\n    identifier: ResourceIdentifier,\n    data: Guarded<Readable>,\n    metadata: RepresentationMetadata,\n  ): Promise<void> {\n    // Write the actual data to unstructured storage\n    await this.unstructuredDataAccessor.writeDocument(identifier, data, metadata);\n    \n    // Get the metadata from unstructured storage (includes size, etc.)\n    let updatedMetadata = await this.unstructuredDataAccessor.getMetadata(identifier);\n    \n    // Filter out invalid quads\n    const removing: Quad[] = [];\n    for (const quad of updatedMetadata.quads()) {\n      if (!/^http/.test(quad.predicate.value)) {\n        removing.push(quad);\n      }\n    }\n    updatedMetadata.removeQuads(removing);\n    \n    // Save metadata to structured storage\n    try {\n      await this.structuredDataAccessor.writeMetadata(identifier, updatedMetadata);\n    } catch (error) {\n      this.logger.error(`Error writing metadata for ${identifier.path}: ${error}`);\n      // Rollback: delete the unstructured data\n      await this.unstructuredDataAccessor.deleteResource(identifier);\n      throw error;\n    }\n  }\n}\n"]}