1
0
Fork 0
mirror of https://github.com/classchartsapi/classcharts-api-js.git synced 2026-05-14 19:59:37 +00:00

fix: cleanup code

This commit is contained in:
James Cook 2021-12-12 14:33:32 +00:00
parent 33f235c7d7
commit d9a234bd7e
6 changed files with 2 additions and 72 deletions

View file

@ -1,55 +0,0 @@
/**
* Helper functions for requesting individual students instead of making a whole client
* Using a client should be prefered over performance reasons
*/
import { ClasschartsClient } from '.'
import {
ActivityResponse,
BehaviourResponse,
GetActivityOptions,
GetBehaviourOptions,
GetHomeworkOptions,
GetLessonsOptions,
HomeworksResponse,
LessonsResponse,
Student,
} from '../types'
export async function getStudentInfo(
studentCode: string,
dateOfBirth?: string
): Promise<Student> {
const client = new ClasschartsClient(studentCode, dateOfBirth)
return await client.getStudentInfo()
}
export async function getActivity(
studentCode: string,
dateOfBirth?: string,
options?: GetActivityOptions
): Promise<ActivityResponse> {
const client = new ClasschartsClient(studentCode, dateOfBirth)
return await client.getActivity(options)
}
export async function getBehaviour(
studentCode: string,
dateOfBirth?: string,
options?: GetBehaviourOptions
): Promise<BehaviourResponse> {
const client = new ClasschartsClient(studentCode, dateOfBirth)
return await client.getBehaviour(options)
}
export async function listHomeworks(
studentCode: string,
dateOfBirth?: string,
options?: GetHomeworkOptions
): Promise<HomeworksResponse> {
const client = new ClasschartsClient(studentCode, dateOfBirth)
return await client.listHomeworks(options)
}
export async function getLessons(
studentCode: string,
dateOfBirth?: string,
options?: GetLessonsOptions
): Promise<LessonsResponse> {
const client = new ClasschartsClient(studentCode, dateOfBirth)
return await client.getLessons(options)
}

View file

@ -11,7 +11,7 @@ import {
HomeworksResponse,
LessonsResponse,
Student,
} from '../types'
} from './types'
import { API_BASE, BASE_URL } from './consts'
/**
* The base client
@ -97,7 +97,6 @@ export class ClasschartsClient {
* @returns Student object
*/
async getStudentInfo(): Promise<Student> {
if (!this.authCookies) throw new Error('Not authenticated')
const data = await this.makeAuthedRequest(API_BASE + '/ping', {
method: 'POST',
body: 'include_date=true',
@ -149,7 +148,6 @@ export class ClasschartsClient {
async listHomeworks(
options?: GetHomeworkOptions
): Promise<HomeworksResponse> {
if (!this.authCookies) throw new Error('Not authenticated')
const params = new URLSearchParams()
if (options?.displayDate) params.append('display_date', String(options?.displayDate))
options?.fromDate && params.append('from', String(options?.fromDate))
@ -177,7 +175,6 @@ export class ClasschartsClient {
* @returns Array of lessons
*/
async getLessons(options?: GetLessonsOptions): Promise<LessonsResponse> {
if (!this.authCookies) throw new Error('Not authenticated')
if (!options?.date) throw new Error('No date specified')
const params = new URLSearchParams()
params.append('date', String(options?.date))

View file

@ -1,2 +1 @@
export * from './client'
export * from './api'

View file

@ -1,10 +0,0 @@
import { ClasschartsClient } from '../client'
const { code, dob } = require('../../src/tests/config.json')
async function main() {
const client = new ClasschartsClient(code, dob)
await client.init()
console.log(await client.getBehaviour())
console.log(await client.getActivity())
}
main()

145
src/types.ts Normal file
View file

@ -0,0 +1,145 @@
export interface Student {
id: number
name: string
first_name: string
last_name: string
avatar_url: string
display_behaviour: boolean
display_parent_behaviour: boolean
display_homework: boolean
display_rewards: boolean
display_detentions: boolean
display_report_cards: boolean
display_classes: boolean
display_announcements: boolean
display_attendance: boolean
display_attendance_type: string
display_attendance_percentage: boolean
display_activity: boolean
display_mental_health: boolean
display_timetable: boolean
is_disabled: boolean
display_two_way_communications: boolean
display_absences: boolean
can_upload_attachments: string | null
display_event_badges: boolean
display_avatars: boolean
display_concern_submission: boolean
display_custom_fields: boolean
pupil_concerns_help_text: string
allow_pupils_add_timetable_notes: boolean
announcements_count: number
messages_count: number
pusher_channel_name: string
has_birthday: boolean
has_new_survey: boolean
survey_id: number | null
detention_alias_plural_uc: string
}
export interface GetActivityOptions {
from?: string
to?: string
}
export interface ActivityTimelinePoint {
positive: number
negative: number
name: string
start: string
end: string
}
export interface ActivityResponse {
timeline: Array<ActivityTimelinePoint>
positiveReasons: Record<string, string>
negative_reasons: Record<string, string>
other_positive: Array<any>
other_negative: Array<any>
other_positive_count: Array<any>
other_negative_count: Array<any>
}
export interface GetBehaviourOptions {
from?: string
to?: string
last_id?: string
}
export interface BehaviourPoint {
id: number
type: string
polarity: string
reason: string
score: number
timestamp: string
timestamp_custom_time: string | null
style: {
border_color: string | null
custom_class: string | null
}
pupil_name: string
lesson_name: string
teacher_name: string
room_name: string | null
note: string
_can_delete: string
detention_date: string | null
detention_time: string | null
detention_location: string | null
detention_type: string | null
}
export type BehaviourResponse = Array<BehaviourPoint>
export type DisplayDate = 'due_date' | 'issue_date'
export interface GetHomeworkOptions {
displayDate?: DisplayDate
fromDate?: string
toDate?: string
}
export interface Homework {
lesson: string
subject: string
teacher: string
homework_type: string
id: number
title: string
meta_title: string
description: string
issue_date: string
due_date: string
completion_time_unit: string
completion_time_value: string
publish_time: string
status: {
id: number
state: null
mark: null
mark_relative: number
ticked: 'yes' | 'no'
allow_attachments: string
first_seen_date: string
last_seen_date: string
attachments: Array<any>
has_feedback: boolean
}
validated_links: Array<any>
validated_attachments: Array<any>
}
export type HomeworksResponse = Array<Homework>
export interface GetLessonsOptions {
date: string
}
export interface Lesson {
teacher_name: string
lesson_name: string
subject_name: string
is_alternative_lesson: boolean
period_name: string
period_number: string
room_name: string
date: string
start_time: string
end_time: string
key: number
note_abstract: string
note: string
pupil_note_abstract: string
pupil_note: string
pupil_note_raw: string
}
export type LessonsResponse = Array<Lesson>