feat: initial proposal for multithreaded execution

test/unit/init/cluster/SingleThreaded.test.ts

@@ -0,0 +1,61 @@
+import { ComponentsManager } from 'componentsjs';
+import type { Resource } from 'rdf-object';
+import { listSingleThreadedComponents } from '../../../../src';
+
+const moduleState = {
+  contexts: {
+    'https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^5.0.0/components/context.jsonld': 'dist/components/context.jsonld',
+  },
+};
+
+const mockResource: Resource = {
+  isA: jest.fn().mockReturnValue(true),
+  value: '#ViolatingClass',
+  property: { type: { value: '#ViolatingClass' }},
+} as any;
+
+const myExpandTerm = jest.fn().mockImplementation((): any => 'http://myFullIRI');
+
+function mockComponentsManagerFn(length: number): jest.Mocked<ComponentsManager<any>> {
+  const resources: Resource[] = Array.from<Resource>({ length }).fill(mockResource);
+  return { moduleState, getInstantiatedResources: jest.fn((): any => resources) } as any;
+}
+
+jest.mock('jsonld-context-parser/lib/ContextParser', (): any => ({
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  ContextParser: jest.fn().mockImplementation((): any => ({
+    parse: jest.fn(async(): Promise<any> => ({
+      expandTerm: jest.fn((): any => myExpandTerm()),
+    })),
+  })),
+}));
+
+jest.mock('componentsjs', (): any => ({
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  ComponentsManager: {
+    build: jest.fn(async(props: any): Promise<ComponentsManager<any>> => mockComponentsManagerFn(props.length)),
+  },
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  PrefetchedDocumentLoader: jest.fn().mockImplementation((): any => ({
+    load: jest.fn(),
+  })),
+}));
+
+describe('A SingleThreaded', (): void => {
+  it('has a listSingleThreadedComponents that works with 1 resource.', async(): Promise<void> => {
+    const comp = await ComponentsManager.build({ length: 1 } as any);
+    await expect(listSingleThreadedComponents(comp)).resolves.toEqual([ 'ViolatingClass' ]);
+  });
+
+  it('has a listSingleThreadedComponents that works with multiple resources.', async(): Promise<void> => {
+    const comp = await ComponentsManager.build({ length: 2 } as any);
+    await expect(listSingleThreadedComponents(comp)).resolves.toEqual([ 'ViolatingClass', 'ViolatingClass' ]);
+  });
+
+  it('errors when the interface IRI cannot be expanded.', async(): Promise<void> => {
+    myExpandTerm.mockReturnValueOnce(null);
+    const comp = await ComponentsManager.build({} as any);
+    await expect(listSingleThreadedComponents(comp)).rejects
+      .toThrow(/^Could not expand .* to IRI!/u);
+  });
+});