Merge branch 'main' of github.com:flotte-meets-hwr-db/apollo-server into main

src/datasources/db/cargobikeAPI.ts

@@ -26,7 +26,7 @@ import { Equipment } from '../../model/Equipment';
 import { Engagement } from '../../model/Engagement';
 import { Provider } from '../../model/Provider';
 import { TimeFrame } from '../../model/TimeFrame';
-import { ActionLogger, deleteEntity, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, getAllEntity, LockUtils } from './utils';
 import { EquipmentType } from '../../model/EquipmentType';
 import { BikeEventType } from '../../model/BikeEventType';
 import { UserInputError } from 'apollo-server-express';
@@ -42,14 +42,8 @@ export class CargoBikeAPI extends DataSource {
         this.connection = getConnection();
     }
 
-    async getCargoBikes (offset: number, limit: number) {
-        return await this.connection.createQueryBuilder()
-            .select('cargoBike')
-            .from(CargoBike, 'cargoBike')
-            .orderBy('name', 'ASC')
-            .offset(offset)
-            .limit(limit)
-            .getMany();
+    async getCargoBikes (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, CargoBike, 'cb', offset, limit);
     }
 
     /**
@@ -221,7 +215,14 @@ export class CargoBikeAPI extends DataSource {
             .loadOne();
     }
 
-    async bikeEventsByCargoBikeId (id: number, offset: number = 0, limit:number = 100) {
+    async bikeEventsByCargoBikeId (id: number, offset?: number, limit?: number) {
+        if (offset === null || limit === null) {
+            return await this.connection.getRepository(CargoBike)
+                .createQueryBuilder('cb')
+                .relation(CargoBike, 'bikeEvents')
+                .of(id)
+                .loadMany();
+        } else {
             return await this.connection.getRepository(CargoBike)
                 .createQueryBuilder('cb')
                 .skip(offset)
@@ -230,6 +231,7 @@ export class CargoBikeAPI extends DataSource {
                 .of(id)
                 .loadMany();
         }
+    }
 
     async createBikeEventType (bikeEventType: any) {
         return (await this.connection.getRepository(BikeEventType)
@@ -267,22 +269,12 @@ export class CargoBikeAPI extends DataSource {
         return await this.bikeEventTypeById(bikeEventType.id);
     }
 
-    async bikeEventTypes (offset: number, limit: number) {
-        return await this.connection.getRepository(BikeEventType)
-            .createQueryBuilder('bet')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async bikeEventTypes (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, BikeEventType, 'bet', offset, limit);
     }
 
-    async bikeEvents (offset: number, limit: number) {
-        return await this.connection.getRepository(BikeEvent)
-            .createQueryBuilder('be')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async bikeEvents (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, BikeEvent, 'be', offset, limit);
     }
 
     async bikeEventTypeById (id: number) {
@@ -343,13 +335,23 @@ export class CargoBikeAPI extends DataSource {
      * @param limit
      * @param id
      */
-    async equipmentByCargoBikeId (offset: number, limit: number, id: number) {
+    async equipmentByCargoBikeId (id: number, offset?: number, limit?: number) {
+        if (offset == null || limit === null) {
+            return await this.connection.getRepository(Equipment)
+                .createQueryBuilder('equipment')
+                .select()
+                .where('equipment."cargoBikeId" = :id', { id: id })
+                .getMany();
+        } else {
             return await this.connection.getRepository(Equipment)
                 .createQueryBuilder('equipment')
                 .select()
                 .where('equipment."cargoBikeId" = :id', { id: id })
+                .skip(offset)
+                .take(limit)
                 .getMany();
         }
+    }
 
     async createEquipment ({ equipment }: { equipment: any }) {
         return await this.connection.getRepository(Equipment)

src/datasources/db/contactinformationAPI.ts

@@ -21,7 +21,7 @@ import { DataSource } from 'apollo-datasource';
 import { Connection, EntityManager, getConnection } from 'typeorm';
 import { ContactInformation } from '../../model/ContactInformation';
 import { Person } from '../../model/Person';
-import { ActionLogger, deleteEntity, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, getAllEntity, LockUtils } from './utils';
 import { GraphQLError } from 'graphql';
 import { LendingStation } from '../../model/LendingStation';
 
@@ -32,13 +32,8 @@ export class ContactInformationAPI extends DataSource {
         this.connection = getConnection();
     }
 
-    async contactInformation (offset: number, limit: number) {
-        return await this.connection.getRepository(ContactInformation)
-            .createQueryBuilder('ci')
-            .select()
-            .offset(offset)
-            .limit(limit)
-            .getMany();
+    async contactInformation (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, ContactInformation, 'ci', offset, limit);
     }
 
     async contactInformationById (id: number) {
@@ -91,13 +86,8 @@ export class ContactInformationAPI extends DataSource {
         return await deleteEntity(this.connection, Person, 'p', id, userId);
     }
 
-    async persons (offset: number, limit: number) {
-        return await this.connection.getRepository(Person)
-            .createQueryBuilder('person')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async persons (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Person, 'p', offset, limit);
     }
 
     async personById (id: number) {

src/datasources/db/lendingstationAPI.ts

@@ -24,7 +24,7 @@ import { Connection, EntityManager, getConnection } from 'typeorm';
 import { CargoBike } from '../../model/CargoBike';
 import { LendingStation } from '../../model/LendingStation';
 import { TimeFrame } from '../../model/TimeFrame';
-import { ActionLogger, deleteEntity, genDateRange, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, genDateRange, getAllEntity, LockUtils } from './utils';
 
 export class LendingStationAPI extends DataSource {
     connection : Connection
@@ -44,14 +44,8 @@ export class LendingStationAPI extends DataSource {
     /**
      * get all lendingStations
      */
-    async lendingStations (offset: number, limit: number) {
-        return await this.connection.getRepository(LendingStation)
-            .createQueryBuilder('lendingStation')
-            .select()
-            .offset(offset)
-            .limit(limit)
-            .orderBy('name', 'ASC')
-            .getMany() || new GraphQLError('Internal Server Error: could not query data from table lendingStation');
+    async lendingStations (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, LendingStation, 'ls', offset, limit);
     }
 
     /**
@@ -79,13 +73,8 @@ export class LendingStationAPI extends DataSource {
             .loadOne();
     }
 
-    async timeFrames (offset: number, limit: number) {
-        return await this.connection.getRepository(TimeFrame)
-            .createQueryBuilder('timeframe')
-            .select()
-            .offset(offset)
-            .limit(limit)
-            .getMany() || [];
+    async timeFrames (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, TimeFrame, 'tf', offset, limit);
     }
 
     async timeFramesByCargoBikeId (id: number) {

src/datasources/db/participantAPI.ts

@@ -23,7 +23,7 @@ import { ContactInformation } from '../../model/ContactInformation';
 import { Engagement } from '../../model/Engagement';
 import { Participant } from '../../model/Participant';
 import { EngagementType } from '../../model/EngagementType';
-import { ActionLogger, deleteEntity, genDateRange, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, genDateRange, getAllEntity, LockUtils } from './utils';
 import { UserInputError } from 'apollo-server-express';
 import { GraphQLError } from 'graphql';
 
@@ -42,13 +42,8 @@ export class ParticipantAPI extends DataSource {
             .getOne();
     }
 
-    async getParticipants (offset: number, limit: number) {
-        return await this.connection.getRepository(Participant)
-            .createQueryBuilder('participant')
-            .select()
-            .offset(offset)
-            .limit(limit)
-            .getMany();
+    async getParticipants (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Participant, 'p', offset, limit);
     }
 
     async participantByEngagementId (id: number) {
@@ -84,18 +79,25 @@ export class ParticipantAPI extends DataSource {
             .getMany();
     }
 
-    async engagementByCargoBikeId (offset: number, limit: number, id: number) {
+    async engagementByCargoBikeId (id: number, offset?: number, limit?: number) {
+        if (limit === null || offset === null) {
+            return await this.connection.getRepository(Engagement)
+                .createQueryBuilder('engagement')
+                .select()
+                .where('engagement."cargoBikeId" = :id', { id: id })
+                .orderBy('engagement."dateRange"', 'DESC')
+                .getMany();
+        } else {
             return await this.connection.getRepository(Engagement)
                 .createQueryBuilder('engagement')
                 .select()
-            .where('engagement."cargoBikeId" = :id', {
-                id: id
-            })
+                .where('engagement."cargoBikeId" = :id', { id: id })
                 .skip(offset)
                 .take(limit)
                 .orderBy('engagement."dateRange"', 'DESC')
                 .getMany();
         }
+    }
 
     async currentEngagementByCargoBikeId (id: number) {
         return await this.connection.getRepository(Engagement)
@@ -107,13 +109,8 @@ export class ParticipantAPI extends DataSource {
             .getMany();
     }
 
-    async engagements (offset: number, limit: number) {
-        return await this.connection.getRepository(Engagement)
-            .createQueryBuilder('e')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async engagements (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Engagement, 'e', offset, limit);
     }
 
     async engagementById (id: number) {
@@ -132,13 +129,8 @@ export class ParticipantAPI extends DataSource {
             .getOne();
     }
 
-    async engagementTypes (offset: number, limit: number) {
-        return await this.connection.getRepository(EngagementType)
-            .createQueryBuilder('et')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async engagementTypes (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Engagement, 'e', offset, limit);
     }
 
     async engagementTypeByEngagementId (id: number) {

src/datasources/db/providerAPI.ts

@@ -24,7 +24,7 @@ import { Organisation } from '../../model/Organisation';
 import { UserInputError } from 'apollo-server-express';
 import { CargoBike } from '../../model/CargoBike';
 import { LendingStation } from '../../model/LendingStation';
-import { ActionLogger, deleteEntity, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, getAllEntity, LockUtils } from './utils';
 import { GraphQLError } from 'graphql';
 
 export class ProviderAPI extends DataSource {
@@ -42,13 +42,8 @@ export class ProviderAPI extends DataSource {
             .getOne();
     }
 
-    async provider (offset: number, limit: number) {
-        return await this.connection.getRepository(Provider)
-            .createQueryBuilder('provider')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async provider (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Provider, 'p', offset, limit);
     }
 
     async providerByOrganisationId (id: number) {
@@ -75,13 +70,8 @@ export class ProviderAPI extends DataSource {
             .loadOne();
     }
 
-    async organisations (offset: number, limit: number) {
-        return await this.connection.getRepository(Organisation)
-            .createQueryBuilder('o')
-            .select()
-            .skip(offset)
-            .limit(limit)
-            .getMany();
+    async organisations (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Organisation, 'o', offset, limit);
     }
 
     async organisationById (id: number) {

src/datasources/db/utils.ts

@@ -64,6 +64,22 @@ export async function deleteEntity (connection: Connection, target: ObjectType<L
     });
 }
 
+export async function getAllEntity (connection: Connection, target: ObjectType<any>, alias: string, offset?: number, limit?: number) {
+    if (offset === null || limit === null) {
+        return await connection.getRepository(target)
+            .createQueryBuilder(alias)
+            .select()
+            .getMany();
+    } else {
+        return await connection.getRepository(target)
+            .createQueryBuilder(alias)
+            .select()
+            .skip(offset)
+            .take(limit)
+            .getMany();
+    }
+}
+
 export class LockUtils {
     static async findById (connection: Connection, target: ObjectType<Lockable>, alias: string, id: number): Promise<Lockable> {
         return await connection.getRepository(target)

src/datasources/db/workshopAPI.ts

@@ -21,7 +21,7 @@ import { DataSource } from 'apollo-datasource';
 import { Connection, EntityManager, getConnection } from 'typeorm';
 import { WorkshopType } from '../../model/WorkshopType';
 import { Workshop } from '../../model/Workshop';
-import { ActionLogger, deleteEntity, LockUtils } from './utils';
+import { ActionLogger, deleteEntity, getAllEntity, LockUtils } from './utils';
 import { UserInputError } from 'apollo-server-express';
 import { GraphQLError } from 'graphql';
 import { Participant } from '../../model/Participant';
@@ -126,13 +126,8 @@ export class WorkshopAPI extends DataSource {
             .getOne();
     }
 
-    async workshopTypes (offset: number, limit: number) {
-        return await this.connection.getRepository(WorkshopType)
-            .createQueryBuilder('w')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async workshopTypes (offset?: number, limit?: number) {
+        return getAllEntity(this.connection, WorkshopType, 'wt', offset, limit);
     }
 
     async workshopById (id: number) {
@@ -148,13 +143,8 @@ export class WorkshopAPI extends DataSource {
      * @param offset
      * @param limit
      */
-    async workshops (offset: number, limit: number) {
-        return await this.connection.getRepository(Workshop)
-            .createQueryBuilder('w')
-            .select()
-            .skip(offset)
-            .take(limit)
-            .getMany();
+    async workshops (offset?: number, limit?: number) {
+        return await getAllEntity(this.connection, Workshop, 'w', offset, limit);
     }
 
     async trainer1ByWorkshopId (id: number) {

src/resolvers/cargoBikeResolver.ts

@@ -30,14 +30,14 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        cargoBikes: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        cargoBikes: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadBike)) {
                 return dataSources.cargoBikeAPI.getCargoBikes(offset, limit);
             } else {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        bikeEvents: (_:any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        bikeEvents: (_:any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadBikeEvent)) {
                 return dataSources.cargoBikeAPI.bikeEvents(offset, limit);
             } else {
@@ -58,14 +58,14 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        bikeEventTypes: (_:any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        bikeEventTypes: (_:any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadBikeEvent)) {
                 return dataSources.cargoBikeAPI.bikeEventTypes(offset, limit);
             } else {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        equipment: (_:any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        equipment: (_:any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadEquipment)) {
                 return dataSources.cargoBikeAPI.getEquipment(offset, limit);
             } else {
@@ -79,7 +79,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        equipmentTypes: (_:any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        equipmentTypes: (_:any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadEquipment)) {
                 return dataSources.cargoBikeAPI.equipmentTypes(offset, limit);
             } else {
@@ -102,23 +102,23 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        engagement (parent: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) {
+        engagement (parent: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) {
             if (req.permissions.includes(Permission.ReadEngagement)) {
-                return dataSources.participantAPI.engagementByCargoBikeId(offset, limit, parent.id);
+                return dataSources.participantAPI.engagementByCargoBikeId(parent.id, offset, limit);
             } else {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        participants (parent: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) { // TODO should be done with engagements
+        participants (parent: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) { // TODO should be done with engagements
             if (req.permissions.includes(Permission.ReadParticipant)) {
                 return dataSources.participantAPI.participantsByCargoBikeId(parent.id);
             } else {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        equipment (parent: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) {
+        equipment (parent: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) {
             if (req.permissions.includes(Permission.ReadEquipment)) {
-                return dataSources.cargoBikeAPI.equipmentByCargoBikeId(offset, limit, parent.id);
+                return dataSources.cargoBikeAPI.equipmentByCargoBikeId(parent.id, offset, limit);
             } else {
                 return new GraphQLError('Insufficient Permissions');
             }
@@ -130,7 +130,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        bikeEvents (parent: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) {
+        bikeEvents (parent: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) {
             if (req.permissions.includes(Permission.ReadBikeEvent)) {
                 return dataSources.cargoBikeAPI.bikeEventsByCargoBikeId(parent.id, offset, limit);
             } else {
@@ -173,6 +173,10 @@ export default {
         isLockedByMe: (parent: any, __: any, { req }: { req: any }) => isLockedByMe(parent, { req }),
         isLocked: (parent: any, __: any, { req }: { req: any }) => isLocked(parent, { req })
     },
+    EquipmentType: {
+        isLockedByMe: (parent: any, __: any, { req }: { req: any }) => isLockedByMe(parent, { req }),
+        isLocked: (parent: any, __: any, { req }: { req: any }) => isLocked(parent, { req })
+    },
     BikeEvent: {
         cargoBike (parent: any, __: any, { dataSources, req }: { dataSources: any, req: any }) {
             if (req.permissions.includes(Permission.ReadBike)) {

src/resolvers/contactInformationResolvers.ts

@@ -24,7 +24,7 @@ import { isLocked, isLockedByMe } from '../datasources/db/utils';
 
 export default {
     Query: {
-        contactInformation: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        contactInformation: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadPerson)) {
                 return dataSources.contactInformationAPI.contactInformation(offset, limit);
             } else {
@@ -45,7 +45,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        persons: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        persons: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadPerson)) {
                 return dataSources.contactInformationAPI.persons(offset, limit);
             } else {

src/resolvers/lendingStationResolvers.ts

@@ -31,7 +31,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        lendingStations: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        lendingStations: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadLendingStation)) {
                 return dataSources.lendingStationAPI.lendingStations(offset, limit);
             } else {
@@ -45,7 +45,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        timeframes: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        timeFrames: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadTimeFrame)) {
                 return dataSources.lendingStationAPI.timeFrames(offset, limit);
             } else {

src/resolvers/participantResolvers.ts

@@ -30,7 +30,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        participants: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        participants: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadParticipant)) {
                 return dataSources.participantAPI.getParticipants(offset, limit);
             } else {
@@ -44,7 +44,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        engagements: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        engagements: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadEngagement)) {
                 return dataSources.participantAPI.engagements(offset, limit);
             } else {
@@ -58,7 +58,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        engagementTypes: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        engagementTypes: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadEngagement)) {
                 return dataSources.participantAPI.engagementTypes(offset, limit);
             } else {

src/resolvers/providerResolvers.ts

@@ -23,7 +23,7 @@ import { isLocked, isLockedByMe } from '../datasources/db/utils';
 
 export default {
     Query: {
-        providers: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        providers: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadProvider)) {
                 return dataSources.providerAPI.provider(offset, limit);
             } else {
@@ -37,7 +37,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        organisations: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        organisations: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadOrganisation)) {
                 return dataSources.providerAPI.organisations(offset, limit);
             } else {

src/resolvers/workshopResolvers.ts

@@ -31,7 +31,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        workshopTypes: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        workshopTypes: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadWorkshop)) {
                 return dataSources.workshopAPI.workshopTypes(offset, limit);
             } else {
@@ -45,7 +45,7 @@ export default {
                 return new GraphQLError('Insufficient Permissions');
             }
         },
-        workshops: (_: any, { offset, limit }: { offset: number, limit: number }, { dataSources, req }: { dataSources: any, req: any }) => {
+        workshops: (_: any, { offset, limit }: { offset?: number, limit?: number }, { dataSources, req }: { dataSources: any, req: any }) => {
             if (req.permissions.includes(Permission.ReadWorkshop)) {
                 return dataSources.workshopAPI.workshops(offset, limit);
             } else {

src/schema/type-defs.ts

@@ -33,7 +33,6 @@ There is a currency signe at the first position or second position if - is set.
     The kind of currency depends on the database.
     """
     scalar Money
-
     "The CargoBike type is central to the graph. You could call it the root."
     type CargoBike {
         id: ID!
@@ -58,8 +57,10 @@ type CargoBike {
         Does not refer to an extra table in the database.
         """
         dimensionsAndLoad: DimensionsAndLoad!
+        "If offset or limit is not provided, both values are ignored"
         bikeEvents(offset: Int, limit: Int): [BikeEvent]
-    equipment(offset: Int!, limit: Int!): [Equipment]
+        "If offset or limit is not provided, both values are ignored"
+        equipment(offset: Int, limit: Int): [Equipment]
         "Refers to equipment that is not unique. See kommentierte info tabelle -> Fragen -> Frage 2"
         equipmentType: [EquipmentType]
         "Sticker State"
@@ -72,7 +73,8 @@ type CargoBike {
         lendingStation: LendingStation
         taxes: Taxes
         currentEngagements: [Engagement]
-    engagement(offset: Int!, limit: Int!): [Engagement]
+        "If offset or limit is not provided, both values are ignored"
+        engagement(offset: Int, limit: Int): [Engagement]
         timeFrames: [TimeFrame]
         isLocked: Boolean!
         isLockedByMe: Boolean!
@@ -357,6 +359,9 @@ enum Group{
         TK
     }
 
+    """
+    A participant in the organization
+    """
     type Participant {
         id: ID!
         start: Date!
@@ -417,6 +422,9 @@ input ParticipantUpdateInput {
         keepLock: Boolean
     }
 
+    """
+    A workshop event
+    """
     type Workshop {
         id: ID!
         title: String!
@@ -582,6 +590,10 @@ input EquipmentUpdateInput {
         keepLock: Boolean
     }
 
+    """
+    A type of equipment that is not being tracked but can be assigned
+    to any bike.
+    """
     type EquipmentType {
         id: ID!
         name: String!
@@ -617,7 +629,7 @@ type BikeEvent {
         """
         Path to documents
         """
-    documents: [String]!    
+        documents: [String!]!
         remark: String
         isLocked: Boolean!
         isLockedByMe: Boolean!
@@ -661,6 +673,8 @@ type BikeEventType {
         name: String!
         isLockedByMe: Boolean!
         isLocked: Boolean!
+        "null if not locked by other user"
+        lockedBy: ID
         lockedUntil: Date
     }
 
@@ -676,7 +690,7 @@ type Provider {
         formName: String
         privatePerson: ContactInformation
         organisation: Organisation
-    cargoBikes: [CargoBike]
+        cargoBikes: [CargoBike!]
         isLocked: Boolean!
         isLockedByMe: Boolean!
         "null if not locked by other user"
@@ -689,7 +703,7 @@ input ProviderCreateInput {
         formName: String!
         privatePersonId: ID
         organisationId: ID
-    cargoBikeIds: [ID]
+        cargoBikeIds: [ID!]
     }
 
     input ProviderUpdateInput {
@@ -710,7 +724,7 @@ type Person {
         id: ID!
         name: String!
         firstName: String!
-    contactInformation: [ContactInformation]
+        contactInformation: [ContactInformation!]
         isLocked: Boolean!
         isLockedByMe: Boolean!
         "null if not locked by other user"
@@ -770,7 +784,7 @@ type Organisation {
         name: String!
         address: Address
         "(dt. Ausleihstation)"
-    lendingStations: [LendingStation]
+        lendingStations: [LendingStation!]
         "registration number of association"
         associationNo: String
         "If Club, at what court registered"
@@ -816,9 +830,9 @@ type LendingStation {
         contactInformationIntern: ContactInformation
         contactInformationExtern: ContactInformation
         address: Address!
-    timeFrames: [TimeFrame]!
+        timeFrames: [TimeFrame!]!
         loanPeriod: LoanPeriod
-    cargoBikes: [CargoBike]
+        cargoBikes: [CargoBike!]
         "Total amount of cargoBikes currently assigned to the lending station"
         numCargoBikes: Int!
         organisation: Organisation
@@ -875,12 +889,12 @@ type LoanPeriod {
     input LoanPeriodInput {
         generalRemark: String
         "notes for each day of the week, starting on Monday"
-    notes: [String]
+        notes: [String!]
         """
         Loan times from and until for each day of the week.
         Starting with Monday from, Monday to, Tuesday from, ..., Sunday to
         """
-    loanTimes: [String]
+        loanTimes: [String!]
     }
 
     "(dt. Zeitscheibe) When was a bike where"
@@ -951,48 +965,62 @@ type ActionLog {
     type Query {
         "Will (eventually) return all properties of cargo bike"
         cargoBikeById(id:ID!): CargoBike
-    "returns cargoBikes ordered by name ascending, relations are not loaded, use cargoBikeById instead"
-    cargoBikes(offset: Int!, limit: Int!): [CargoBike]!
+        "Returns cargoBikes ordered by name ascending. If offset or limit is not provided, both values are ignored."
+        cargoBikes(offset: Int, limit: Int): [CargoBike!]!
         engagementById(id: ID!): Engagement
-    engagements(offset: Int!, limit: Int!): [Engagement]!
+        "If offset or limit is not provided, both values are ignored"
+        engagements(offset: Int, limit: Int): [Engagement!]!
         engagementTypeById(id: ID!): EngagementType
-    engagementTypes(offset: Int!, limit: Int!): [EngagementType]!
+        "If offset or limit is not provided, both values are ignored"
+        engagementTypes(offset: Int, limit: Int): [EngagementType!]!
         "equipment by id, will return null if id not found"
         equipmentById(id: ID!): Equipment
-    equipment(offset: Int!, limit: Int!): [Equipment]!
+        "If offset or limit is not provided, both values are ignored"
+        equipment(offset: Int, limit: Int): [Equipment!]!
         equipmentTypeById(id: ID!): EquipmentType
-    equipmentTypes(offset: Int!, limit: Int!): [EquipmentType]!
+        "If offset or limit is not provided, both values are ignored"
+        equipmentTypes(offset: Int, limit: Int): [EquipmentType!]!
         "return null if id not found"
         providerById(id:ID!): Provider
-    "unique equipment with pagination, contains relation to bike (with no further joins), so if you wanna know more about the bike, use cargoBikeById"
-    providers(offset: Int!, limit: Int!): [Provider]!
+        "Returns providers with pagination. If offset or limit is not provided, both values are ignored"
+        providers(offset: Int, limit: Int): [Provider!]!
         "participant by id"
         participantById(id:ID!):  Participant
-    participants(offset: Int!, limit: Int!): [ Participant]!
+        "If offset or limit is not provided, both values are ignored"
+        participants(offset: Int, limit: Int): [Participant!]!
         workshopTypeById(id: ID!): WorkshopType
-    workshopTypes(offset: Int!, limit: Int!): [WorkshopType]!
+        "If offset or limit is not provided, both values are ignored"
+        workshopTypes(offset: Int, limit: Int): [WorkshopType!]!
         workshopById(id: ID!): Workshop
-    workshops(offset: Int!, limit: Int!): [Workshop]!
+        "If offset or limit is not provided, both values are ignored"
+        workshops(offset: Int, limit: Int): [Workshop!]!
         lendingStationById(id:ID!): LendingStation
-    lendingStations(offset: Int!, limit: Int!): [LendingStation]!
+        "If offset or limit is not provided, both values are ignored"
+        lendingStations(offset: Int, limit: Int): [LendingStation!]!
         organisationById(id: ID!): Organisation
-    organisations(offset: Int!, limit: Int!): [Organisation]!
+        "If offset or limit is not provided, both values are ignored"
+        organisations(offset: Int, limit: Int): [Organisation!]!
         timeFrameById(id: ID!): TimeFrame
-    timeframes(offset: Int!, limit: Int!): [TimeFrame]!
+        "If offset or limit is not provided, both values are ignored"
+        timeFrames(offset: Int, limit: Int): [TimeFrame!]!
         contactInformationById(id: ID!): ContactInformation
-    contactInformation(offset: Int!, limit: Int!): [ContactInformation]!
+        "If offset or limit is not provided, both values are ignored"
+        contactInformation(offset: Int, limit: Int): [ContactInformation!]!
         personById(id: ID!): Person
-    persons(offset: Int!, limit: Int!): [Person]
-    bikeEventTypes(offset: Int!, limit: Int!): [BikeEventType]
+        "If offset or limit is not provided, both values are ignored"
+        persons(offset: Int, limit: Int): [Person!]
+        "If offset or limit is not provided, both values are ignored"
+        bikeEventTypes(offset: Int, limit: Int): [BikeEventType!]
         bikeEventTypeByd(id: ID!): BikeEventType
-    bikeEvents(offset: Int!, limit: Int!): [BikeEvent]!
+        "If offset or limit is not provided, both values are ignored"
+        bikeEvents(offset: Int, limit: Int): [BikeEvent!]!
         bikeEventById(id:ID!): BikeEvent
         "actionLog for current user"
-    actionLog: [ActionLog]
+        actionLog: [ActionLog!]
         "actionLog for specific user"
-    actionLogByUser(id: ID!): [ActionLog]
+        actionLogByUser(id: ID!): [ActionLog!]
         "actionLog form all users"
-    actionLogAll: [ActionLog]
+        actionLogAll: [ActionLog!]
     }
 
     type Mutation {