@ominira/pomi-sdk 0.1.0

package/src/openapi/specs.json

@@ -0,0 +1 @@
+{"openapi":"3.0.0","info":{"version":"1.0.0","title":"Pomi","description":"This is the API"},"servers":[{"url":"","description":"POMI"}],"components":{"schemas":{"ProfessorEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"}},"required":["entity"]}},"required":["id","name","_paths"],"additionalProperties":false},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["message","errors"]},"InstituteEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"_paths":{"type":"object","properties":{"classes":{"type":"string"},"coursesOfferings":{"type":"string"},"courses":{"type":"string"}},"required":["classes","coursesOfferings","courses"]}},"required":["id","name","_paths"],"additionalProperties":false},"CourseEntity":{"type":"object","properties":{"id":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"credits":{"type":"integer"},"_paths":{"type":"object","properties":{"classes":{"type":"string"},"courseOfferings":{"type":"string"}},"required":["classes","courseOfferings"],"additionalProperties":false}},"required":["id","code","name","credits","_paths"],"additionalProperties":false},"ClassEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"reservations":{"type":"array","items":{"type":"integer"}},"courseOfferingId":{"type":"integer"},"studyPeriodId":{"type":"integer"},"studyPeriodName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"professors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"_paths":{"type":"object","properties":{"studyPeriod":{"type":"string"},"institute":{"type":"string"},"course":{"type":"string"},"courseOffering":{"type":"string"},"class":{"type":"string"},"classSchedules":{"type":"string"},"professors":{"type":"string"}},"required":["studyPeriod","institute","course","courseOffering","class","classSchedules","professors"],"additionalProperties":false}},"required":["id","name","reservations","courseOfferingId","studyPeriodId","studyPeriodName","courseId","courseCode","instituteId","instituteName","professors","_paths"],"additionalProperties":false},"CourseOfferingEntity":{"type":"object","properties":{"id":{"type":"integer"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"studyPeriodId":{"type":"integer"},"studyPeriodName":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"},"institute":{"type":"string"},"studyPeriod":{"type":"string"},"course":{"type":"string"}},"required":["entity","institute","studyPeriod","course"]}},"required":["id","instituteId","instituteName","courseId","courseCode","studyPeriodId","studyPeriodName","_paths"],"additionalProperties":false},"DaysOfWeekEnum":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"ClassScheduleEntity":{"type":"object","properties":{"id":{"type":"integer"},"dayOfWeek":{"$ref":"#/components/schemas/DaysOfWeekEnum"},"start":{"type":"string"},"end":{"type":"string"},"roomId":{"type":"integer"},"roomCode":{"type":"string"},"classId":{"type":"integer"},"className":{"type":"string"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"courseOfferingId":{"type":"integer"},"periodId":{"type":"integer"},"periodName":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"},"studyPeriod":{"type":"string"},"institute":{"type":"string"},"course":{"type":"string"},"courseOffering":{"type":"string"},"class":{"type":"string"}},"required":["entity","studyPeriod","institute","course","courseOffering","class"],"additionalProperties":false}},"required":["id","dayOfWeek","start","end","roomId","roomCode","classId","className","instituteId","instituteName","courseId","courseCode","courseOfferingId","periodId","periodName","_paths"],"additionalProperties":false},"StudyPeriodEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"_paths":{"type":"object","properties":{"courseOfferings":{"type":"string"},"classes":{"type":"string"},"classSchedules":{"type":"string"}},"required":["courseOfferings","classes","classSchedules"]}},"required":["id","name","startDate","endDate","_paths"],"additionalProperties":false},"RoomEntity":{"type":"object","properties":{"id":{"type":"integer"},"code":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"}},"required":["entity"]}},"required":["id","code","_paths"],"additionalProperties":false}},"parameters":{}},"paths":{"/professors":{"get":{"tags":["professor"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"classId","in":"query"}],"responses":{"200":{"description":"A list of professors","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfessorEntity"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"500":{"description":"Internal server error"}}}},"/professors/{id}":{"get":{"tags":["professor"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A professor by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfessorEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/institutes":{"get":{"tags":["institute"],"responses":{"200":{"description":"A list of institutes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstituteEntity"}}}}},"500":{"description":"Internal server error"}}}},"/institutes/{id}":{"get":{"tags":["institute"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"An institute by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstituteEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/courses":{"get":{"tags":["course"],"responses":{"200":{"description":"A list of courses","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CourseEntity"}}}}},"500":{"description":"Internal server error"}}}},"/courses/{id}":{"get":{"tags":["course"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A course by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CourseEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/classes":{"get":{"tags":["class"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"professorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"professorName","in":"query"}],"responses":{"200":{"description":"A list of classes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClassEntity"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"500":{"description":"Internal server error"}}}},"/classes/{id}":{"get":{"tags":["class"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A class","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClassEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/course-offerings":{"get":{"tags":["course-offering"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"}],"responses":{"200":{"description":"A list of course offerings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CourseOfferingEntity"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"500":{"description":"Internal server error"}}}},"/course-offerings/{id}":{"get":{"tags":["course-offering"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A course offering by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CourseOfferingEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/class-schedules":{"get":{"tags":["class-schedule"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"roomId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"roomCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"classId","in":"query"},{"schema":{"$ref":"#/components/schemas/DaysOfWeekEnum"},"required":false,"name":"dayOfWeek","in":"query"}],"responses":{"200":{"description":"A list of class schedules","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClassScheduleEntity"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"500":{"description":"Internal server error"}}}},"/class-schedules/{id}":{"get":{"tags":["class-schedule"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A class schedule by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClassScheduleEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/study-periods":{"get":{"tags":["studyPeriod"],"responses":{"200":{"description":"A list of study periods","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StudyPeriodEntity"}}}}},"500":{"description":"Internal server error"}}}},"/study-periods/{id}":{"get":{"tags":["studyPeriod"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"A study period by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudyPeriodEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}},"/rooms":{"get":{"tags":["room"],"responses":{"200":{"description":"A list of rooms","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RoomEntity"}}}}},"500":{"description":"Internal server error"}}}},"/rooms/{id}":{"get":{"tags":["room"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A room by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoomEntity"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"404":{"description":"Not found"},"500":{"description":"Internal server error"}}}}}}

package/src/result.ts

@@ -0,0 +1,12 @@
+type Result<V, E> = 
+	{ data: V, error: never }
+	| { data: never, error: E }
+
+function ResultOK<V, E>(data: V): Result<V, E> {
+	return { data, error: undefined as never };
+}
+function ResultErr<V, E>(error: E): Result<V, E> {
+	return { data: undefined as never, error };
+}
+export { ResultOK, ResultErr }
+export type { Result } 

package/src/services/classScheduleService.ts

@@ -0,0 +1,55 @@
+import type { ClientType } from "../client";
+import { invalidParamError as invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { ClassScheduleEntitySchema } from "../models";
+import type { paths } from "../openapi/specs";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+type ListFilters = paths["/class-schedules"]["get"]["parameters"]["query"];
+
+class ClassScheduleService {
+	constructor(private client: ClientType) { }
+	async get(classScheduleId: number): Promise<Result<ClassScheduleEntitySchema | null, PomiError>> {
+		if (false && !Number.isInteger(classScheduleId) || classScheduleId <= 0) {
+			return ResultErr(invalidParamError("Invalid class schedule ID", [
+				{ path: ["classScheduleId"], message: "Must be a positive integer" }
+			]))
+		}
+		const { data, error, response } = await this.client.GET(`/class-schedules/{id}`, {
+			params: {
+				path: {
+					id: classScheduleId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid class schedule ID", error.errors ?? [
+					{ path: ["classScheduleId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(listFilters?: ListFilters): Promise<Result<ClassScheduleEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/class-schedules`, {
+			params: {
+				query: listFilters,
+			}
+		});
+		if (response?.status === 400 )
+			return ResultErr(invalidParamError("Invalid query parameters", error?.errors ?? [], { originalError: error, response }));
+		if (response?.status != 200) {
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default ClassScheduleService
+export type { ListFilters as ClassScheduleListFilters }

package/src/services/classService.ts

@@ -0,0 +1,50 @@
+import type { ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { ClassEntitySchema } from "../models";
+import type { paths } from "../openapi/specs";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+type ListFilters = paths["/classes"]["get"]["parameters"]["query"];
+
+class ClassService {
+	constructor(private client: ClientType) { }
+	async get(classId: number): Promise<Result<ClassEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/classes/{id}`, {
+			params: {
+				path: {
+					id: classId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid class ID", [
+					{ path: ["classId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(listFilters?: ListFilters): Promise<Result<ClassEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/classes`, {
+			params: {
+				query: listFilters,
+			}
+		});
+		if (error) {
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid query parameters", error.errors ?? [], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default ClassService
+export type { ListFilters as ClassListFilters }

package/src/services/courseOfferingService.ts

@@ -0,0 +1,50 @@
+import type { ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { CourseOfferingEntitySchema } from "../models";
+import type { paths } from "../openapi/specs";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+type ListFilters = paths["/course-offerings"]["get"]["parameters"]["query"];
+
+class CourseOfferingService {
+	constructor(private client: ClientType) { }
+	async get(courseOfferingId: number): Promise<Result<CourseOfferingEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/course-offerings/{id}`, {
+			params: {
+				path: {
+					id: courseOfferingId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid course offering ID", [
+					{ path: ["courseOfferingId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(listFilters?: ListFilters): Promise<Result<CourseOfferingEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/course-offerings`, {
+			params: {
+				query: listFilters,
+			}
+		});
+		if (error) {
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid query parameters", error.errors ?? [], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default CourseOfferingService
+export type { ListFilters as CourseOfferingListFilters }

package/src/services/courseService.ts

@@ -0,0 +1,40 @@
+import type { ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { CourseEntitySchema } from "../models";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+class CourseService {
+	constructor(private client: ClientType) { }
+	async get(courseId: number): Promise<Result<CourseEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/courses/{id}`, {
+			params: {
+				path: {
+					id: courseId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid course ID", [
+					{ path: ["courseId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(): Promise<Result<CourseEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/courses`, {});
+		if (error) {
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default CourseService

package/src/services/instituteService.ts

@@ -0,0 +1,40 @@
+import { type ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { InstituteEntitySchema } from "../models";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+class InstituteService {
+	constructor(private client: ClientType) { }
+	async get(instituteId: number): Promise<Result<InstituteEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/institutes/{id}`, {
+			params: {
+				path: {
+					id: instituteId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid institute ID", [
+					{ path: ["instituteId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(): Promise<Result<InstituteEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/institutes`, {});
+		if (error) {
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default InstituteService

package/src/services/professorService.ts

@@ -0,0 +1,50 @@
+import type { ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { ProfessorEntitySchema } from "../models";
+import type { paths } from "../openapi/specs";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+type ListFilters = paths["/professors"]["get"]["parameters"]["query"];
+
+class ProfessorService {
+	constructor(private client: ClientType) { }
+	async get(professorId: number): Promise<Result<ProfessorEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/professors/{id}`, {
+			params: {
+				path: {
+					id: professorId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid professor ID", error.errors ?? [
+					{ path: ["professorId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(listFilters?: ListFilters): Promise<Result<ProfessorEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/professors`, {
+			params: {
+				query: listFilters,
+			}
+		});
+		if (error) {
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid query parameters", error.errors ?? [], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default ProfessorService
+export type { ListFilters as ProfessorListFilters }

package/src/services/studyPeriodService.ts

@@ -0,0 +1,40 @@
+import type { ClientType } from "../client";
+import { invalidParamError, serverError, unknownError, type PomiError } from "../errors";
+import type { StudyPeriodEntitySchema } from "../models";
+import { ResultErr, ResultOK, type Result } from "../result";
+
+class StudyPeriodService {
+	constructor(private client: ClientType) { }
+	async get(studyPeriodId: number): Promise<Result<StudyPeriodEntitySchema | null, PomiError>> {
+		const { data, error, response } = await this.client.GET(`/study-periods/{id}`, {
+			params: {
+				path: {
+					id: studyPeriodId,
+				}
+			}
+		});
+		if (error) {
+			if (response?.status === 404)
+				return ResultOK(null);
+			if (response?.status === 400)
+				return ResultErr(invalidParamError("Invalid study period ID", [
+					{ path: ["studyPeriodId"], message: "Must be a positive integer" }
+				], { originalError: error, response }));
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? null);
+	}
+	async list(): Promise<Result<StudyPeriodEntitySchema[], PomiError>> {
+		const { data, error, response } = await this.client.GET(`/study-periods`, {});
+		if (error) {
+			if (response?.status === 500)
+				return ResultErr(serverError("Server error occurred", { originalError: error, response }));
+			return ResultErr(unknownError("An unknown error occurred", { originalError: error, response }));
+		}
+		return ResultOK(data ?? []);
+	}
+}
+
+export default StudyPeriodService

package/src/services.ts

@@ -0,0 +1,6 @@
+import ClassScheduleService from "./services/classScheduleService";
+import ClassService from "./services/classService";
+import CourseService from "./services/courseService";
+import CourseOfferingService from "./services/courseOfferingService";
+import ProfessorService from "./services/professorService";
+import StudyPeriodService from "./services/studyPeriodService";

package/src/specs.json

@@ -0,0 +1 @@
+{"openapi":"3.0.0","info":{"version":"1.0.0","title":"Pomi","description":"This is the API"},"servers":[{"url":"","description":"POMI"}],"components":{"schemas":{"ProfessorEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"}},"required":["entity"]}},"required":["id","name","_paths"],"additionalProperties":false},"InstituteEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"_paths":{"type":"object","properties":{"classes":{"type":"string"},"coursesOfferings":{"type":"string"},"courses":{"type":"string"}},"required":["classes","coursesOfferings","courses"]}},"required":["id","name","_paths"],"additionalProperties":false},"CourseEntity":{"type":"object","properties":{"id":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"credits":{"type":"integer"},"_paths":{"type":"object","properties":{"classes":{"type":"string"},"courseOfferings":{"type":"string"}},"required":["classes","courseOfferings"],"additionalProperties":false}},"required":["id","code","name","credits","_paths"],"additionalProperties":false},"ClassEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"reservations":{"type":"array","items":{"type":"integer"}},"courseOfferingId":{"type":"integer"},"studyPeriodId":{"type":"integer"},"studyPeriodName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"professors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"_paths":{"type":"object","properties":{"studyPeriod":{"type":"string"},"institute":{"type":"string"},"course":{"type":"string"},"courseOffering":{"type":"string"},"class":{"type":"string"},"classSchedules":{"type":"string"},"professors":{"type":"string"}},"required":["studyPeriod","institute","course","courseOffering","class","classSchedules","professors"],"additionalProperties":false}},"required":["id","name","reservations","courseOfferingId","studyPeriodId","studyPeriodName","courseId","courseCode","instituteId","instituteName","professors","_paths"],"additionalProperties":false},"CourseOfferingEntity":{"type":"object","properties":{"id":{"type":"integer"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"studyPeriodId":{"type":"integer"},"studyPeriodName":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"},"institute":{"type":"string"},"studyPeriod":{"type":"string"},"course":{"type":"string"}},"required":["entity","institute","studyPeriod","course"]}},"required":["id","instituteId","instituteName","courseId","courseCode","studyPeriodId","studyPeriodName","_paths"],"additionalProperties":false},"DaysOfWeekEnum":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"ClassScheduleEntity":{"type":"object","properties":{"id":{"type":"integer"},"dayOfWeek":{"$ref":"#/components/schemas/DaysOfWeekEnum"},"start":{"type":"string"},"end":{"type":"string"},"roomId":{"type":"integer"},"roomCode":{"type":"string"},"classId":{"type":"integer"},"className":{"type":"string"},"instituteId":{"type":"integer"},"instituteName":{"type":"string"},"courseId":{"type":"integer"},"courseCode":{"type":"string"},"courseOfferingId":{"type":"integer"},"periodId":{"type":"integer"},"periodName":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"},"studyPeriod":{"type":"string"},"institute":{"type":"string"},"course":{"type":"string"},"courseOffering":{"type":"string"},"class":{"type":"string"}},"required":["entity","studyPeriod","institute","course","courseOffering","class"],"additionalProperties":false}},"required":["id","dayOfWeek","start","end","roomId","roomCode","classId","className","instituteId","instituteName","courseId","courseCode","courseOfferingId","periodId","periodName","_paths"],"additionalProperties":false},"StudyPeriodEntity":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"_paths":{"type":"object","properties":{"courseOfferings":{"type":"string"},"classes":{"type":"string"},"classSchedules":{"type":"string"}},"required":["courseOfferings","classes","classSchedules"]}},"required":["id","name","startDate","endDate","_paths"],"additionalProperties":false},"RoomEntity":{"type":"object","properties":{"id":{"type":"integer"},"code":{"type":"string"},"_paths":{"type":"object","properties":{"entity":{"type":"string"}},"required":["entity"]}},"required":["id","code","_paths"],"additionalProperties":false}},"parameters":{}},"paths":{"/professors":{"get":{"tags":["professor"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"classId","in":"query"}],"responses":{"200":{"description":"A list of professors","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfessorEntity"}}}}}}}},"/professors/{id}":{"get":{"tags":["professor"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A list of professors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfessorEntity"}}}}}}},"/institutes":{"get":{"tags":["institute"],"responses":{"200":{"description":"A list of institutes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstituteEntity"}}}}}}}},"/institutes/{id}":{"get":{"tags":["institute"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A list of institutes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstituteEntity"}}}}}}},"/courses":{"get":{"tags":["course"],"responses":{"200":{"description":"A list of courses","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CourseEntity"}}}}}}}},"/courses/{id}":{"get":{"tags":["course"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A list of courses","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CourseEntity"}}}},"404":{"description":"Course not found"}}}},"/classes":{"get":{"tags":["class"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"professorId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"professorName","in":"query"}],"responses":{"200":{"description":"A list of classes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClassEntity"}}}}}}}},"/classes/{id}":{"get":{"tags":["class"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A class","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClassEntity"}}}}}}},"/course-offerings":{"get":{"tags":["course-offering"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"}],"responses":{"200":{"description":"A list of course offerings","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CourseOfferingEntity"}}}}}}}},"/course-offerings/{id}":{"get":{"tags":["course-offering"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A list of course offerings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CourseOfferingEntity"}}}}}}},"/class-schedules":{"get":{"tags":["class-schedule"],"parameters":[{"schema":{"type":"integer","nullable":true},"required":false,"name":"periodId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"periodName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"instituteId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"instituteName","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"courseId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"courseCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"roomId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"roomCode","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"classId","in":"query"},{"schema":{"$ref":"#/components/schemas/DaysOfWeekEnum"},"required":false,"name":"dayOfWeek","in":"query"}],"responses":{"200":{"description":"A list of class schedules","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClassScheduleEntity"}}}}}}}},"/class-schedules/{id}":{"get":{"tags":["class-schedule"],"parameters":[{"schema":{"type":"integer"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"A class schedule","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClassScheduleEntity"}}}}}}},"/study-periods":{"get":{"tags":["studyPeriod"],"responses":{"200":{"description":"A list of study periods","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StudyPeriodEntity"}}}}}}}},"/study-periods/{id}":{"get":{"tags":["studyPeriod"],"responses":{"200":{"description":"A study period by id","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StudyPeriodEntity"}}}}}}}},"/rooms":{"get":{"tags":["room"],"responses":{"200":{"description":"A list of rooms","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RoomEntity"}}}}}}}},"/rooms/:id":{"get":{"tags":["room"],"responses":{"200":{"description":"A room by id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoomEntity"}}}}}}}}}

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false,
+
+    "declaration": true
+  }
+}