mirror of
https://github.com/CommunitySolidServer/CommunitySolidServer.git
synced 2024-10-03 14:55:10 +00:00

* feat: only allow metadata to be edited with PATCH request & only allow metadata files to be edited when a resource is available * fix: remove unnecesary log at POST * feat: PUT resets metadata contents + not possible to add metadata with PUT to container * feat: add metadataStrategy (auxiliaryStrategy) + use that strategy in operationhandlers * feat: PUT request on existing LDPC is not allowed as it would be possible to edit (read reset) metadata * test: add unit tests to operationhandlers to handle metadata editing * test: add unit tests to representationPatchHandler to handle metadata editing * fix: update dependency of meta.json to version 3.0.0 * fix: lint and dependency still v2 * fix: replaced file references to resource references + moved Patch check to new patchhandler which is more generic * fix: moved checking metadata resources checking from DELETE and POST handler down to DABS * fix: remove PATCH message about metadata extension * fix: move PATCH message about metadata extension * WIP: adding writeMetadata + getMetadata in DABS and add writeMetadata to DataAccessors (part 1) * WIP: implement writeMetadata in memorybackend + change resourceExists * WIP: implement writeMetadata in SparqlDataAccessor.ts * test: fix test interfaces * test: InMemoryDataAccessor.ts resulted into changing identifier for writeMetadata in DataAccessor.ts (now taking subject identifier instead of metadata resource identifier) * test: accessor tests implemented for metadata * test: add RdfImmutableCheckPatcher.test.ts * test: add tests in DataAccessorBasedStore.test.ts * test: fix template config for DynamicPods test * test: add integration tests for metadata * fix: change metaStrategy to metadataStrategy * refactor: comments updated to new location CSS on github + some alphabetical edits * refactor: remove getMetadata function in DABS as it is only used once * refactor: add DataAccessorBasedStoreArgs to DataAccessorBasedStore.ts * docs: modify documentation for writeMetadata function in DataAccessor.ts * feat: ldp:contains is also part of the metadata resource of a container * refactor: change function name and move check to DataAccessorBasedStore * fix: fix tests for DABS and PutOperationHandler * feat: avoid cloneRepresentation by introducing RdfPatcher, RdfStorePatcher and modifying ImmutableMetadataPatcher, N3Patcher, patching.json and SparqlUpdatePatcher * test: fix patcher tests * feat: create sparqlInsertMetadata in SparqlDataAccessor.ts * fix: move check during put on container if it exists already back to PutOperationHandler.ts after discussion in PR * test: update tests PutOperationHandler.ts and DataAccessorBasedStore.ts regarding previous commit * test: add converter to DABS and replace rejection on data during container creation to warning * test: implemented RdfPatcher test * feat: remove ContainerPatcher * fix: fix lint * fix: fix integration tests * refactor: fix minor issues mentioned in the PR * WIP: problem with removeResponseMetadata * refactor: remove responseMetadata in QuadToRdfConverter.ts * feat: handle ResponeMetadata when writing to the store via a patch * refactor: refactor based on comments in PR * feat: make ImmutableMetadataPatcher.ts instantiation more clear * test: achieve 100% coverage again * fix: fix lint * refactor: return to explicit arguments for the DABS * fix: return to explicit arguments for the DABS (missed one) * feat: optimise immutable checker * fix: fix, enhance docs + optimise config files * fix: DABS + QuadToRdfConverter feedback implemented * fix: patching feedback implemented * test: update operationhandler tests * test: update integration tests after feedback * test: update DABS tests after feedback * test: update ImmutableMetadataPatcher.test.ts after feedback * test: update patch tests after feedback * docs: add documentation about editing metadata * fix: config: intendation + name change + extra filters | filter pattern * docs: tsdoc added to RdfStorePatcher.ts * fix: DABS split implemented for getRepresentation + comment refactoring * docs: further documentation on removing response data on serialization * fix: DABS getRepresentation method * docs: apply feedback from Joachim on the documentation of metadata-editing.md * fix: indentation fix + fix metadata-editing.md documentation after feedback from Joachim * docs: small fix in metadata-editing.md documentation after feedback from Joachim * fix: fix metadata-editing.md documentation after feedback from Joachim * fix: fix tests meta-editing after feedback Joachim * feat: first attempt at RELEASE_NOTES.md * docs: update release notes based on feedback * docs: fix newline * fix: patching config changes after feedback * docs: metadata editing documentation changes after feedback * docs: metadata editing documentation changes after feedback * docs: metadata editing documentation changes after feedback * feat: optimisation on ImmutableMetadataPatcher.ts algorithm * feat: remove converter from DABS and add conversion for metadata resources in the RCS * fix: Fix documentation RepresentationPatchHandler.ts + fix response graph not being stored due to convertingstore * feat: make RepresentationPatcher generic * test: generic RepresentationPatcher tests * test: 100% coverage for patchers again * feat: containers can be created with POST with no content-type * feat: Immutable checks always with subject identifier * feat: create AuxiliaryLinkMetadataWriter for adding description resources Link Header * test: add tests for AuxiliaryLinkMetadataWriter and update them for ImmutableMetadataPatcher * feat: remove metadataGenerator from acl.json and fix tests accordingly * WIP: preserve metadata on PUT * feat: preserve metadata on PUT * fix: keep metadata on PATCHes * test: add unit tests for preserving metadata on PUT * fix: remove inConverter from sparql endpoint as that is already the default in the (converting.json) * fix: add metadatastrategy to RepresentationConvertingStore in regex.json * test: add integration tests for preserving metadata on PUT * docs: update release notes and adding documentation about preserving metadata on PUT * WIP: Template create setRepresentation * fix: Move container exists and not allowed check to setRepresentation * test: fix lint * fix: update configs and documentation * refactor: update and add documentation + small refactoring * refactor: update and add documentation + small refactoring + fix tests * fix: Dynamic pod config + tests * fix: TemplatedResourcesGenerator does not create containers when they already exist * fix: metadata preservation now deals with complex content types * docs: explain the case when there is no content-type * fix: minor comments
730 lines
25 KiB
TypeScript
730 lines
25 KiB
TypeScript
import { createReadStream } from 'fs';
|
|
import fetch from 'cross-fetch';
|
|
import type { Quad } from 'n3';
|
|
import { DataFactory, Parser, Store } from 'n3';
|
|
import { joinFilePath, PIM, RDF } from '../../src/';
|
|
import type { App } from '../../src/';
|
|
import { LDP } from '../../src/util/Vocabularies';
|
|
import {
|
|
deleteResource,
|
|
expectQuads,
|
|
getResource,
|
|
patchResource,
|
|
postResource,
|
|
putResource,
|
|
} from '../util/FetchUtil';
|
|
import { getPort } from '../util/Util';
|
|
import {
|
|
getDefaultVariables,
|
|
getPresetConfigPath,
|
|
getTestConfigPath,
|
|
getTestFolder,
|
|
instantiateFromConfig,
|
|
removeFolder,
|
|
} from './Config';
|
|
const { literal, namedNode, quad } = DataFactory;
|
|
|
|
const port = getPort('LpdHandlerWithoutAuth');
|
|
const baseUrl = `http://localhost:${port}/`;
|
|
const metaSuffix = '.meta';
|
|
const rootFilePath = getTestFolder('full-config-no-auth');
|
|
const stores: [string, any][] = [
|
|
[ 'in-memory storage', {
|
|
storeConfig: 'storage/backend/memory.json',
|
|
teardown: jest.fn(),
|
|
}],
|
|
[ 'on-disk storage', {
|
|
storeConfig: 'storage/backend/file.json',
|
|
teardown: async(): Promise<void> => removeFolder(rootFilePath),
|
|
}],
|
|
];
|
|
|
|
describe.each(stores)('An LDP handler allowing all requests %s', (name, { storeConfig, teardown }): void => {
|
|
let app: App;
|
|
|
|
beforeAll(async(): Promise<void> => {
|
|
const variables = {
|
|
...getDefaultVariables(port, baseUrl),
|
|
'urn:solid-server:default:variable:rootFilePath': rootFilePath,
|
|
};
|
|
|
|
// Create and start the server
|
|
const instances = await instantiateFromConfig(
|
|
'urn:solid-server:test:Instances',
|
|
[
|
|
getPresetConfigPath(storeConfig),
|
|
getTestConfigPath('ldp-with-auth.json'),
|
|
],
|
|
variables,
|
|
) as Record<string, any>;
|
|
({ app } = instances);
|
|
|
|
await app.start();
|
|
});
|
|
|
|
afterAll(async(): Promise<void> => {
|
|
await teardown();
|
|
await app.stop();
|
|
});
|
|
|
|
it('returns the root container listing.', async(): Promise<void> => {
|
|
const response = await getResource(baseUrl, {}, { contentType: 'text/turtle' });
|
|
|
|
await expect(response.text()).resolves.toContain('ldp:BasicContainer');
|
|
expect(response.headers.get('link')).toContain(`<${PIM.Storage}>; rel="type"`);
|
|
});
|
|
|
|
it('returns the root container listing when asking for */*.', async(): Promise<void> => {
|
|
const response = await getResource(baseUrl, { accept: '*/*' }, { contentType: 'text/turtle' });
|
|
|
|
await expect(response.text()).resolves.toContain('ldp:BasicContainer');
|
|
expect(response.headers.get('link')).toContain(`<${PIM.Storage}>; rel="type"`);
|
|
});
|
|
|
|
it('can read a container listing with a query string.', async(): Promise<void> => {
|
|
// Helper functions would fail due to query params
|
|
const response = await fetch(`${baseUrl}?abc=def&xyz`, { headers: { accept: 'text/turtle' }});
|
|
expect(response.status).toBe(200);
|
|
expect(response.headers.get('content-type')).toBe('text/turtle');
|
|
expect(response.headers.get('link')).toContain(`<${LDP.Container}>; rel="type"`);
|
|
expect(response.headers.get('link')).toContain(`<${baseUrl}.acl>; rel="acl"`);
|
|
expect(response.headers.get('link')).toContain(`<${PIM.Storage}>; rel="type"`);
|
|
|
|
const parser = new Parser({ baseIRI: baseUrl });
|
|
const quads = parser.parse(await response.text());
|
|
const store = new Store(quads);
|
|
expect(store.countQuads(namedNode(baseUrl), RDF.terms.type, LDP.terms.Container, null)).toBe(1);
|
|
});
|
|
|
|
it('can add a document to the store, read it and delete it.', async(): Promise<void> => {
|
|
const documentUrl = `${baseUrl}document.txt`;
|
|
// PUT
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// GET
|
|
const response = await getResource(documentUrl, {}, { contentType: 'text/plain' });
|
|
await expect(response.text()).resolves.toBe('TESTFILE0');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can add and overwrite a document.', async(): Promise<void> => {
|
|
const documentUrl = `${baseUrl}document.txt`;
|
|
// PUT
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// GET
|
|
let response = await getResource(documentUrl, {}, { contentType: 'text/plain' });
|
|
await expect(response.text()).resolves.toBe('TESTFILE0');
|
|
|
|
// PUT
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE1', exists: true });
|
|
|
|
// GET
|
|
response = await getResource(documentUrl, {}, { contentType: 'text/plain' });
|
|
await expect(response.text()).resolves.toBe('TESTFILE1');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a container and delete it.', async(): Promise<void> => {
|
|
const containerUrl = `${baseUrl}secondContainer/`;
|
|
// PUT
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// GET
|
|
const response = await getResource(containerUrl);
|
|
|
|
// Verify container listing
|
|
await expectQuads(response, [
|
|
quad(namedNode(containerUrl), RDF.terms.type, LDP.terms.Container),
|
|
]);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a container and retrieve it.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer0/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// GET representation
|
|
const response = await getResource(containerUrl, { accept: '*/*' }, { contentType: 'text/turtle' });
|
|
await expect(response.text()).resolves.toContain('ldp:BasicContainer');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a container and view it as HTML.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer0/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// GET representation
|
|
const response = await getResource(containerUrl, { accept: 'text/html' }, { contentType: 'text/html' });
|
|
await expect(response.text()).resolves.toContain('Contents of testcontainer0');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a container and put a document in it.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer0/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Create document
|
|
const documentUrl = `${containerUrl}testdocument0.txt`;
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// GET document
|
|
const response = await getResource(documentUrl, {}, { contentType: 'text/plain' });
|
|
await expect(response.text()).resolves.toBe('TESTFILE0');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a container without content-type.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer0/`;
|
|
const slug = 'testcontainer1/';
|
|
const putResponse = await fetch(containerUrl, {
|
|
method: 'PUT',
|
|
});
|
|
const postResponse = await fetch(baseUrl, {
|
|
method: 'Post',
|
|
headers: {
|
|
slug,
|
|
link: `<http://www.w3.org/ns/ldp#Container>; rel="type"`,
|
|
},
|
|
});
|
|
|
|
expect(putResponse.status).toBe(201);
|
|
expect(putResponse.headers.get('location')).toBe(containerUrl);
|
|
expect(postResponse.status).toBe(201);
|
|
expect(postResponse.headers.get('location')).toBe(baseUrl + slug);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
expect(await deleteResource(baseUrl + slug)).toBeUndefined();
|
|
});
|
|
it('cannot remove a container when the container contains a document.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testfolder1/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Create document
|
|
const documentUrl = `${containerUrl}testdocument0.txt`;
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// Try to DELETE container
|
|
const response = await fetch(containerUrl, { method: 'DELETE' });
|
|
expect(response.status).toBe(409);
|
|
await expect(response.text()).resolves.toContain('ConflictHttpError: Can only delete empty containers.');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('cannot remove a container when the container contains a subfolder.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer2/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Create subcontainer
|
|
const subContainerUrl = `${containerUrl}subcontainer0/`;
|
|
await putResource(subContainerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Try to DELETE container
|
|
const response = await fetch(containerUrl, { method: 'DELETE' });
|
|
expect(response.status).toBe(409);
|
|
await expect(response.text()).resolves.toContain('ConflictHttpError: Can only delete empty containers.');
|
|
|
|
// DELETE
|
|
expect(await deleteResource(subContainerUrl)).toBeUndefined();
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can read the contents of a container.', async(): Promise<void> => {
|
|
// Create container
|
|
const containerUrl = `${baseUrl}testcontainer3/`;
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Create subfolder
|
|
const subContainerUrl = `${containerUrl}subcontainer0`;
|
|
await putResource(subContainerUrl, { contentType: 'text/turtle' });
|
|
|
|
// Create document
|
|
const documentUrl = `${containerUrl}testfile0.txt`;
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
const response = await getResource(containerUrl);
|
|
await expectQuads(response, [
|
|
quad(namedNode(containerUrl), LDP.terms.contains, namedNode(subContainerUrl)),
|
|
quad(namedNode(containerUrl), LDP.terms.contains, namedNode(documentUrl)),
|
|
]);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
expect(await deleteResource(subContainerUrl)).toBeUndefined();
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can upload and delete an image.', async(): Promise<void> => {
|
|
const documentUrl = `${baseUrl}image.png`;
|
|
const response = await fetch(documentUrl, {
|
|
method: 'PUT',
|
|
headers: {
|
|
'content-type': 'image/png',
|
|
},
|
|
body: createReadStream(joinFilePath(__dirname, '../assets/testimage.png')) as any,
|
|
});
|
|
expect(response.status).toBe(201);
|
|
expect(response.headers.get('location')).toBe(documentUrl);
|
|
await expect(response.text()).resolves.toHaveLength(0);
|
|
|
|
// GET
|
|
await getResource(documentUrl, {}, { contentType: 'image/png' });
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can create a resource with a diamond identifier in the data.', async(): Promise<void> => {
|
|
const slug = 'my-resource';
|
|
|
|
const body = '<> <http://www.w3.org/2000/01/rdf-schema#label> "My Resource" .';
|
|
let response = await postResource(baseUrl, { isContainer: false, contentType: 'text/turtle', slug, body });
|
|
expect(response.headers.get('location')).toBe(`${baseUrl}${slug}`);
|
|
|
|
// GET
|
|
const containerUrl = `${baseUrl}${slug}`;
|
|
response = await getResource(containerUrl);
|
|
|
|
await expectQuads(response, [
|
|
quad(namedNode(containerUrl), namedNode('http://www.w3.org/2000/01/rdf-schema#label'), literal('My Resource')),
|
|
]);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
// https://github.com/CommunitySolidServer/CommunitySolidServer/issues/498
|
|
it('accepts a GET with Content-Length: 0.', async(): Promise<void> => {
|
|
// PUT
|
|
const documentUrl = `${baseUrl}foo/bar`;
|
|
const response = await fetch(documentUrl, {
|
|
method: 'PUT',
|
|
headers: { 'content-length': '0', 'content-type': 'text/turtle' },
|
|
body: '',
|
|
});
|
|
expect(response.status).toBe(201);
|
|
expect(response.headers.get('location')).toBe(documentUrl);
|
|
|
|
// GET
|
|
await getResource(documentUrl);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can handle simple SPARQL updates.', async(): Promise<void> => {
|
|
// POST
|
|
const body = [ '<http://test.com/s1> <http://test.com/p1> <http://test.com/o1>.',
|
|
'<http://test.com/s2> <http://test.com/p2> <http://test.com/o2>.' ].join('\n');
|
|
let response = await postResource(baseUrl, { contentType: 'text/turtle', body });
|
|
const documentUrl = response.headers.get('location')!;
|
|
|
|
// PATCH
|
|
const query = [ 'DELETE { <http://test.com/s1> <http://test.com/p1> <http://test.com/o1> }',
|
|
'INSERT {<http://test.com/s3> <http://test.com/p3> <http://test.com/o3>}',
|
|
'WHERE {}',
|
|
].join('\n');
|
|
await patchResource(documentUrl, query, 'sparql', true);
|
|
|
|
// PATCH using a content-type header with charset
|
|
const query2 = [ 'DELETE { <http://test.com/s2> <http://test.com/p2> <http://test.com/o2> }',
|
|
'INSERT {<#s4> <#p4> <#o4>}',
|
|
'WHERE {}',
|
|
].join('\n');
|
|
response = await fetch(documentUrl, {
|
|
method: 'PATCH',
|
|
headers: {
|
|
'content-type': 'application/sparql-update ; charset=UTF-8',
|
|
},
|
|
body: query2,
|
|
});
|
|
await expect(response.text()).resolves.toHaveLength(0);
|
|
expect(response.status).toBe(205);
|
|
|
|
// GET
|
|
response = await getResource(documentUrl);
|
|
const expected = [
|
|
quad(
|
|
namedNode('http://test.com/s3'),
|
|
namedNode('http://test.com/p3'),
|
|
namedNode('http://test.com/o3'),
|
|
),
|
|
quad(
|
|
namedNode(`${documentUrl}#s4`),
|
|
namedNode(`${documentUrl}#p4`),
|
|
namedNode(`${documentUrl}#o4`),
|
|
),
|
|
];
|
|
await expectQuads(response, expected, true);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can handle simple N3 Patch updates.', async(): Promise<void> => {
|
|
// POST
|
|
const body = [ '<http://test.com/s1> <http://test.com/p1> <http://test.com/o1>.',
|
|
'<http://test.com/s2> <http://test.com/p2> <http://test.com/o2>.' ].join('\n');
|
|
let response = await postResource(baseUrl, { contentType: 'text/turtle', body });
|
|
const documentUrl = response.headers.get('location')!;
|
|
|
|
// PATCH
|
|
const query = [ '@prefix solid: <http://www.w3.org/ns/solid/terms#>.',
|
|
'<> a solid:InsertDeletePatch;',
|
|
'solid:deletes { <http://test.com/s1> <http://test.com/p1> <http://test.com/o1> };',
|
|
'solid:inserts { <http://test.com/s3> <http://test.com/p3> <http://test.com/o3> }.',
|
|
].join('\n');
|
|
await patchResource(documentUrl, query, 'n3', true);
|
|
|
|
// PATCH using a content-type header with charset
|
|
const query2 = [ '@prefix solid: <http://www.w3.org/ns/solid/terms#>.',
|
|
'<> a solid:InsertDeletePatch;',
|
|
'solid:deletes { <http://test.com/s2> <http://test.com/p2> <http://test.com/o2> };',
|
|
'solid:inserts {<#s4> <#p4> <#o4>}.',
|
|
].join('\n');
|
|
response = await fetch(documentUrl, {
|
|
method: 'PATCH',
|
|
headers: {
|
|
'content-type': 'text/n3 ; charset=UTF-8',
|
|
},
|
|
body: query2,
|
|
});
|
|
await expect(response.text()).resolves.toHaveLength(0);
|
|
expect(response.status).toBe(205);
|
|
|
|
// GET
|
|
response = await getResource(documentUrl);
|
|
const expected = [
|
|
quad(
|
|
namedNode('http://test.com/s3'),
|
|
namedNode('http://test.com/p3'),
|
|
namedNode('http://test.com/o3'),
|
|
),
|
|
quad(
|
|
namedNode(`${documentUrl}#s4`),
|
|
namedNode(`${documentUrl}#p4`),
|
|
namedNode(`${documentUrl}#o4`),
|
|
),
|
|
];
|
|
await expectQuads(response, expected, true);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not handle SPARQL updates on containers.', async(): Promise<void> => {
|
|
// POST
|
|
const body = [ '<http://test.com/s1> <http://test.com/p1> <http://test.com/o1>.',
|
|
'<http://test.com/s2> <http://test.com/p2> <http://test.com/o2>.' ].join('\n');
|
|
let response = await postResource(baseUrl, { contentType: 'text/turtle', body, isContainer: true });
|
|
const documentUrl = response.headers.get('location')!;
|
|
|
|
// PATCH
|
|
const query = [ 'DELETE { <http://test.com/s1> <http://test.com/p1> <http://test.com/o1> }',
|
|
'INSERT {<http://test.com/s3> <http://test.com/p3> <http://test.com/o3>}',
|
|
'WHERE {}',
|
|
].join('\n');
|
|
|
|
// We don't want you to PATCH on containers
|
|
response = await fetch(documentUrl, {
|
|
method: 'PATCH',
|
|
headers: {
|
|
'content-type': 'application/sparql-update',
|
|
},
|
|
body: query,
|
|
});
|
|
expect(response.status).toBe(409);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not handle N3 Patch updates on containers.', async(): Promise<void> => {
|
|
// POST
|
|
const body = [ '<http://test.com/s1> <http://test.com/p1> <http://test.com/o1>.',
|
|
'<http://test.com/s2> <http://test.com/p2> <http://test.com/o2>.' ].join('\n');
|
|
let response = await postResource(baseUrl, { contentType: 'text/turtle', body, isContainer: true });
|
|
const documentUrl = response.headers.get('location')!;
|
|
|
|
// PATCH
|
|
const query = [ '@prefix solid: <http://www.w3.org/ns/solid/terms#>.',
|
|
'<> a solid:InsertDeletePatch;',
|
|
'solid:deletes { <http://test.com/s1> <http://test.com/p1> <http://test.com/o1> };',
|
|
'solid:inserts { <http://test.com/s3> <http://test.com/p3> <http://test.com/o3> }.',
|
|
].join('\n');
|
|
|
|
// We don't want you to PATCH on containers
|
|
response = await fetch(documentUrl, {
|
|
method: 'PATCH',
|
|
headers: {
|
|
'content-type': 'text/n3',
|
|
},
|
|
body: query,
|
|
});
|
|
expect(response.status).toBe(409);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('returns 405 for unsupported methods.', async(): Promise<void> => {
|
|
const response = await fetch(baseUrl, { method: 'TRACE' });
|
|
expect(response.status).toBe(405);
|
|
});
|
|
|
|
it('returns 415 for unsupported PATCH types.', async(): Promise<void> => {
|
|
const response = await fetch(baseUrl, { method: 'PATCH', headers: { 'content-type': 'text/plain' }, body: 'abc' });
|
|
expect(response.status).toBe(415);
|
|
});
|
|
|
|
it('maintains prefixes after PATCH operations.', async(): Promise<void> => {
|
|
// POST
|
|
const body = [ '@prefix test: <http://test.com/>.',
|
|
'test:s1 test:p1 test:o1.',
|
|
'test:s2 test:p2 test:o2.' ].join('\n');
|
|
let response = await postResource(baseUrl, { contentType: 'text/turtle', body });
|
|
const documentUrl = response.headers.get('location')!;
|
|
|
|
// PATCH
|
|
const query = [ 'PREFIX test: <http://test.com/>',
|
|
'DELETE { test:s1 test:p1 test:o1 }',
|
|
'INSERT { test:s3 test:p3 test:o3. test:s4 test:p4 test:o4 }',
|
|
'WHERE {}',
|
|
].join('\n');
|
|
await patchResource(documentUrl, query, 'sparql', true);
|
|
|
|
// GET
|
|
response = await getResource(documentUrl);
|
|
const parser = new Parser();
|
|
const quads: Quad[] = [];
|
|
let prefixes: any = {};
|
|
const text = await response.clone().text();
|
|
const promise = new Promise<void>((resolve, reject): void => {
|
|
parser.parse(text, (error, aQuad, prefixHash): any => {
|
|
if (aQuad) {
|
|
quads.push(aQuad);
|
|
}
|
|
if (!aQuad) {
|
|
prefixes = prefixHash;
|
|
resolve();
|
|
}
|
|
if (error) {
|
|
reject(error);
|
|
}
|
|
});
|
|
});
|
|
|
|
await promise;
|
|
|
|
const expected = [
|
|
quad(
|
|
namedNode('http://test.com/s2'),
|
|
namedNode('http://test.com/p2'),
|
|
namedNode('http://test.com/o2'),
|
|
),
|
|
quad(
|
|
namedNode('http://test.com/s3'),
|
|
namedNode('http://test.com/p3'),
|
|
namedNode('http://test.com/o3'),
|
|
),
|
|
quad(
|
|
namedNode('http://test.com/s4'),
|
|
namedNode('http://test.com/p4'),
|
|
namedNode('http://test.com/o4'),
|
|
),
|
|
];
|
|
await expectQuads(response, expected, true);
|
|
expect(prefixes).toEqual({
|
|
test: 'http://test.com/',
|
|
});
|
|
expect(quads).toHaveLength(3);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not delete metadata resources directly.', async(): Promise<void> => {
|
|
const documentUrl = `${baseUrl}document.txt`;
|
|
|
|
// PUT
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// DELETE metadata attempt
|
|
const response = await fetch(documentUrl + metaSuffix, { method: 'DELETE' });
|
|
expect(response.status).toBe(409);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not create metadata directly.', async(): Promise<void> => {
|
|
const slug = `document.txt${metaSuffix}`;
|
|
const documentMetaURL = `${baseUrl}${slug}`;
|
|
|
|
// POST
|
|
const postResponse = await fetch(baseUrl, {
|
|
method: 'POST',
|
|
headers: { 'content-type': 'text/turtle', slug },
|
|
body: '<a> <b> <c>.',
|
|
});
|
|
expect(postResponse.status).toBe(403);
|
|
|
|
// PUT
|
|
const putResponse = await fetch(documentMetaURL, {
|
|
method: 'PUT',
|
|
headers: { 'content-type': 'text/turtle' },
|
|
body: '<a> <b> <c>.',
|
|
});
|
|
expect(putResponse.status).toBe(405);
|
|
|
|
// PATCH
|
|
const patchResponse = await fetch(documentMetaURL, {
|
|
method: 'PATCH',
|
|
headers: { 'content-type': 'application/sparql-update' },
|
|
body: 'INSERT DATA {<a> <b> <c>.}',
|
|
});
|
|
expect(patchResponse.status).toBe(409);
|
|
});
|
|
|
|
it('can update metadata triples using PATCH.', async(): Promise<void> => {
|
|
const documentUrl = `${baseUrl}document.txt`;
|
|
const documentMetaURL = `${documentUrl}${metaSuffix}`;
|
|
|
|
// PUT
|
|
await putResource(documentUrl, { contentType: 'text/plain', body: 'TESTFILE0' });
|
|
|
|
// PATCH
|
|
const patchResponse = await fetch(documentMetaURL, {
|
|
method: 'PATCH',
|
|
headers: { 'content-type': 'application/sparql-update' },
|
|
body: 'INSERT DATA {<a> <b> <c>.}',
|
|
});
|
|
expect(patchResponse.status).toBe(205);
|
|
|
|
// GET
|
|
const response = await fetch(documentMetaURL);
|
|
await expectQuads(response, [ quad(namedNode(`${baseUrl}a`), namedNode(`${baseUrl}b`), namedNode(`${baseUrl}c`)) ]);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(documentUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not update metadata triples that are deemed immutable.', async(): Promise<void> => {
|
|
const containerUrl = `${baseUrl}immutable/`;
|
|
const metaUrl = containerUrl + metaSuffix;
|
|
|
|
// PUT
|
|
await putResource(containerUrl, { contentType: 'text/turtle' });
|
|
|
|
// PATCH
|
|
const pimResponse = await fetch(metaUrl, {
|
|
method: 'PATCH',
|
|
headers: { 'content-type': 'application/sparql-update' },
|
|
body: `INSERT DATA {<${containerUrl}> <${RDF.type}> <${PIM.Storage}>.}`,
|
|
});
|
|
expect(pimResponse.status).toBe(409);
|
|
|
|
const ldpResponse = await fetch(metaUrl, {
|
|
method: 'PATCH',
|
|
headers: { 'content-type': 'application/sparql-update' },
|
|
body: `INSERT DATA {<${containerUrl}> <${LDP.contains}> <b>.}`,
|
|
});
|
|
expect(ldpResponse.status).toBe(409);
|
|
|
|
// DELETE
|
|
expect(await deleteResource(containerUrl)).toBeUndefined();
|
|
});
|
|
|
|
it('can not create metadata resource of a metadata resource.', async(): Promise<void> => {
|
|
const metaUrl = baseUrl + metaSuffix + metaSuffix;
|
|
const response = await fetch(metaUrl, {
|
|
method: 'PATCH',
|
|
headers: { 'content-type': 'application/sparql-update' },
|
|
body: `INSERT DATA {<a> <b> <c>.}`,
|
|
});
|
|
expect(response.status).toBe(409);
|
|
});
|
|
|
|
it('returns metadata resource location in link header.', async(): Promise<void> => {
|
|
const response = await fetch(baseUrl, { method: 'HEAD' });
|
|
expect(response.headers.get('link')).toContain(`<${baseUrl}${metaSuffix}>; rel="describedby"`);
|
|
});
|
|
|
|
it('can read metadata.', async(): Promise<void> => {
|
|
const response = await fetch(baseUrl + metaSuffix);
|
|
expect(response.status).toBe(200);
|
|
await expectQuads(response, [ quad(namedNode(baseUrl), namedNode(RDF.type), namedNode(PIM.Storage)) ]);
|
|
});
|
|
|
|
it('preserves metadata when link header is present.', async(): Promise<void> => {
|
|
const resourceUrl = `${baseUrl}preserved`;
|
|
const metaUrl = resourceUrl + metaSuffix;
|
|
// PUT
|
|
await putResource(resourceUrl, { contentType: 'text/turtle', body: '<a> <b> <c>.' });
|
|
|
|
// PATCH
|
|
await patchResource(metaUrl, `INSERT DATA {<${baseUrl}a> <${baseUrl}b> <${baseUrl}c>.}`, 'sparql', true);
|
|
|
|
// PUT
|
|
const preserveResource = await fetch(resourceUrl, {
|
|
method: 'PUT',
|
|
headers: {
|
|
'content-type': 'text/turtle',
|
|
link: `<${metaUrl}>;rel="preserve"`,
|
|
},
|
|
body: '<a> <b> <d>.',
|
|
});
|
|
expect(preserveResource.status).toBe(205);
|
|
|
|
const metadataResponse = await fetch(metaUrl);
|
|
const metadata = await metadataResponse.text();
|
|
expect(metadata).toContain(`<${baseUrl}a> <${baseUrl}b> <${baseUrl}c>.`);
|
|
|
|
// DELETE
|
|
await deleteResource(resourceUrl);
|
|
});
|
|
|
|
it('clears metadata by default.', async(): Promise<void> => {
|
|
const resourceUrl = `${baseUrl}notPreserved`;
|
|
const metaUrl = resourceUrl + metaSuffix;
|
|
// PUT
|
|
await putResource(resourceUrl, { contentType: 'text/turtle', body: '<a> <b> <c>.' });
|
|
|
|
// PATCH
|
|
await patchResource(metaUrl, `INSERT DATA {<a> <b> <c>.}`, 'sparql', true);
|
|
|
|
// PUT
|
|
await putResource(resourceUrl, { contentType: 'text/turtle', body: '<a> <b> <d>.', exists: true });
|
|
|
|
const metadataResponse = await fetch(metaUrl);
|
|
const metadata = await metadataResponse.text();
|
|
expect(metadata).not.toContain(`<${baseUrl}a> <${baseUrl}b> <${baseUrl}c>.`);
|
|
|
|
// DELETE
|
|
await deleteResource(resourceUrl);
|
|
});
|
|
});
|