parse-comcigan 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pro203S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# parse-comcigan
+
+컴시간을 파싱하는 라이브러리입니다.  
+안드로이드 컴시간알리미 앱에서 파싱합니다.  
+아직 학생 시간표밖에 지원하지 않습니다.  
+
+## 경고
+본 라이브러리는 **비공식적**으로 컴시간알리미의 데이터를 파싱합니다.  
+상업적으로 사용하다 문제가 발생할경우, **제작자는 책임을 지지 않습니다.**
+
+## 설치
+```npm install parse-comcigan```
+
+## 개발
+
+### Comcigan
+
+Comcigan 클래스의 인스턴스를 생성하여 사용합니다.  
+인스턴스를 생성할 때 옵션을 지정할 수 있습니다.
+
+|옵션|타입|기본값|설명|
+|------|------|------|-----------|
+|cacheMs|number|0|캐시될 시간(밀리초)입니다. 0일때 캐시를 비활성화합니다.|
+|doNotThrow|boolean|true|[Axios](https://axios-http.com/)에서 validateStatus를 항상 true로 반환할 지에 대한 여부입니다.|
+|debug|(msg: string) => any|undefined|디버그 메시지를 처리하는 콜백입니다. 이 콜백은 주로 컴시간과 통신할 때 호출됩니다.|
+
+```typescript
+import Comcigan from 'parse-comcigan';
+
+const comci = new Comcigan({
+    "cacheMs": 10000, // 10초동안 캐시됩니다.
+    "doNotThrow": true, // true일때, status가 4 또는 5로 시작하면 throw 됩니다.
+    "debug": (msg) => console.log(msg) // 모듈에서 디버그 메시지를 보내면 콘솔에 출력합니다.
+});
+```
+---
+### SearchSchool
+
+학교를 검색합니다.  
+마지막 "없으면 추가 검색 하세요." 문구는 자동으로 빠져서 나옵니다.  
+당연하지만 컴시간을 사용하는 학교만 검색됩니다.  
+
+|파라메터|타입|필수|설명|
+|------|------|------|-----------|
+|query|string|Yes|검색어|
+
+```typescript
+comci.SearchSchool("서울").then(data => {
+    console.log(data);
+});
+```
+
+다음을 Promise 형태로 리턴합니다.  
+|키|타입|설명|
+|-----|----|-----|
+|region|string|학교의 지역|
+|name|string|학교 이름|
+|code|number|학교 코드|
+
+---
+### GetTimetable
+
+시간표를 가져옵니다.  
+
+|파라메터|타입|필수|설명|
+|------|------|------|-----------|
+|schoolCode|number|Yes|학교 코드|
+|criteria|"weekday" or "period"|Yes|리스트 반환을 어떻게 할지 여부입니다.|
+|grade|number|Yes|학년|
+|classN|number|Yes|반|
+
+```typescript
+comci.GetTimetable(96211, "weekday", 3, 5).then(data => {
+    console.log(data[0][5]); // [요일][교시] 월요일 5교시
+});
+comci.GetTimetable(96211, "period", 3, 5).then(data => {
+    console.log(data[5][0]); // [교시][요일] 월요일 5교시
+});
+```
+
+다음을 Promise 형태로 리턴합니다.  
+|키|타입|설명|
+|-----|----|-----|
+|latestVersion|string|컴시간 앱 최신버전|
+|changed|string|수정된 날짜 시간|
+|timetable|[ComciganTimetableObject](#ComciganTimetableObject)[][]|시간표|
+
+---
+### GetClassList
+
+학급 리스트를 가져옵니다.  
+
+|파라메터|타입|필수|설명|
+|------|------|------|-----------|
+|schoolCode|number|Yes|학교 코드|
+
+```typescript
+comci.GetClassList(96211).then(data => {
+    console.log(data[0]); // 1-1
+});
+```
+
+리턴 타입: ```Promise<string>```
+
+## 타입
+
+### ComciganTimetableObject
+
+|키|타입|설명|필수|
+|-----|----|-----|-----|
+|subject|string|과목|Yes|
+|changed|string|교사|Yes|
+|original|여기서 original만 빠진 오브젝트|원래 시간표|No|
+
+## 업데이트 로그
+
+### 0.0.1
+- 첫번째 릴리즈

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+export interface ComciganInitializeType {
+    /**
+     * 이 기간동안 컴시간과 통신한 데이터가 캐시됩니다.
+     *
+     * 기본값은 0ms이며, 0ms일때는 캐시를 하지 않습니다.
+     */
+    cacheMs?: number;
+    /**
+     * axios에서 요청을 보내고 status가 오류 status일 때 throw할 지 여부입니다.
+     * 만약 false일 때 요청에 status가 오류 status면 그 타입에서 빈 값을 리턴합니다.
+     *
+     * 기본값은 false입니다.
+     */
+    doNotThrow?: boolean;
+    /**
+     * 디버그 메시지를 파라메터로 받습니다.
+     *
+     * 기본값은 없습니다.
+     */
+    debug?: (msg: string) => any;
+}
+export type ComciganSearched = {
+    /**
+     * 학교의 지역입니다.
+     */
+    region: string;
+    /**
+     * 학교의 이름입니다.
+     */
+    name: string;
+    /**
+     * 학교의 코드입니다.
+     */
+    code: number;
+};
+export type ComciganTimetableObject = {
+    /**
+     * 과목입니다.
+     */
+    subject: string;
+    /**
+     * 교사 성명입니다.
+     */
+    teacher: string;
+    /**
+     * 만약 변경되었을때 이 값이 주어집니다.
+     */
+    replacedFrom?: {
+        /**
+         * 과목입니다.
+         */
+        subject: string;
+        /**
+         * 교사 성명입니다.
+         */
+        teacher: string;
+    };
+};
+export type ComciganTimetable = {
+    /**
+     * 컴시간알리미 앱의 최신 버전입니다.
+     */
+    latestVersion: string;
+    /**
+     * 수정일입니다.
+     */
+    changedWhen: string;
+    /**
+     * 시간표입니다.
+     */
+    timetable: ComciganTimetableObject[][];
+};
+export default class Comcigan {
+    private _options;
+    private _cache;
+    private mSb;
+    private mTh;
+    private request;
+    private EUC_KR_encodeURI;
+    /**
+     * 파서를 초기화 합니다.
+     * @param options 파서의 옵션입니다.
+     */
+    constructor(options?: ComciganInitializeType);
+    /**
+     * 학교를 검색합니다.
+     * 마지막 "없으면 추가 검색 하세요" 문구는 빠져서 나옵니다.
+     * @param query 검색어
+     * @returns 검색된 학교들
+     */
+    SearchSchool(query: string): Promise<ComciganSearched[]>;
+    /**
+     * 시간표를 가져옵니다.
+     *
+     * @param schoolCode
+     * @param criteria
+     */
+    GetTimetable(schoolCode: number, criteria: "weekday" | "period", grade: number, classN: number): Promise<ComciganTimetable>;
+    /**
+     * 학급 목록을 가져옵니다.
+     *
+     * @param schoolCode 학교 코드입니다.
+     * @returns (학년)-(반) 문자열이 모인 배열
+     */
+    GetClassList(schoolCode: number): Promise<string[]>;
+}

package/dist/index.js

@@ -0,0 +1,229 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import axios from 'axios';
+import iconv from 'iconv-lite';
+class Cache {
+    constructor() {
+        this._cacheStorage = {};
+    }
+    register(id, data, duration) {
+        this._cacheStorage[id] = {
+            "timeout": setTimeout(() => {
+                delete this._cacheStorage[id];
+            }, duration),
+            "data": data
+        };
+    }
+    delete(id) {
+        clearTimeout(this._cacheStorage[id].timeout);
+        delete this._cacheStorage[id];
+    }
+    clear() {
+        const caches = Object.keys(this._cacheStorage);
+        for (let cache of caches) {
+            clearTimeout(this._cacheStorage[cache].timeout);
+            delete this._cacheStorage[cache];
+        }
+    }
+    has(id) {
+        return Boolean(this._cacheStorage[id]);
+    }
+    get(id) {
+        var _a;
+        return (_a = this._cacheStorage[id]) === null || _a === void 0 ? void 0 : _a.data;
+    }
+}
+//#endregion
+export default class Comcigan {
+    mSb(mm, m2) { if (m2 == 100) {
+        return mm % m2;
+    } return Math.floor(mm / m2); }
+    mTh(mm, m2) { if (m2 == 100) {
+        return Math.floor(mm / m2);
+    } return mm % m2; }
+    request(route, doNotParse) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._cache.has(route)) {
+                this._options.debug ? this._options.debug(`[request] Return cache with id registered as ${route}`) : 0;
+                return this._cache.get(route);
+            }
+            this._options.debug ? this._options.debug(`[request] Requesting to http://comci.kr:4081/${route}`) : 0;
+            const r = yield axios.get(`http://comci.kr:4081/${route}`, Object.assign({}, (this._options.doNotThrow && { "validateStatus": () => true })));
+            if (doNotParse)
+                return r.data;
+            const data = JSON.parse(r.data.slice(0, r.data.indexOf("}") + 1));
+            if (this._options.cacheMs && this._options.cacheMs !== 0) {
+                this._options.debug ? this._options.debug(`[request] Registered cache with id ${route}`) : 0;
+                this._cache.register(route, data, this._options.cacheMs);
+            }
+            return data;
+        });
+    }
+    EUC_KR_encodeURI(str) {
+        const buffer = iconv.encode(str, 'euc-kr');
+        return Array.from(buffer)
+            .map((byte) => '%' + byte.toString(16).toUpperCase().padStart(2, '0'))
+            .join('');
+    }
+    /**
+     * 파서를 초기화 합니다.
+     * @param options 파서의 옵션입니다.
+     */
+    constructor(options) {
+        this._options = {
+            "cacheMs": 0,
+            "doNotThrow": false
+        };
+        this._cache = new Cache();
+        this._options = Object.assign(Object.assign({}, this._options), options);
+    }
+    /**
+     * 학교를 검색합니다.
+     * 마지막 "없으면 추가 검색 하세요" 문구는 빠져서 나옵니다.
+     * @param query 검색어
+     * @returns 검색된 학교들
+     */
+    SearchSchool(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const r = yield this.request(`sc_${this.EUC_KR_encodeURI(query)}`);
+            return r.학교검색.map(v => ({
+                "region": v[1],
+                "name": v[2],
+                "code": v[3]
+            })).filter(v => v.code !== 0);
+        });
+    }
+    /**
+     * 시간표를 가져옵니다.
+     *
+     * @param schoolCode
+     * @param criteria
+     */
+    GetTimetable(schoolCode, criteria, grade, classN) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const str = `36174_${schoolCode}_1_4_0_3_1.00`;
+            const route = (str.substring(9) + str.substring(0, 9)).split("").reverse().join("");
+            const data = yield this.request(`7813?${route}`, true);
+            const [latestVersion, step1] = data.split("^");
+            const edited = step1.substring(0, step1.indexOf("{"));
+            const step2 = step1.slice(step1.indexOf("{"));
+            const json = JSON.parse(step2.slice(0, step2.indexOf("}") + 1));
+            const WEEKDAY = ["월", "화", "수", "목", "금"];
+            const sep = (_a = json.분리) !== null && _a !== void 0 ? _a : 100;
+            // 시간표[학년][반][요일][교시]
+            const origin = json.시간표[grade][classN];
+            const today = json.학급시간표[grade][classN];
+            const toReturn = [];
+            if (criteria === "period") {
+                for (let weekday = 1; weekday < WEEKDAY.length + 1; weekday++) {
+                    const weekdayList = [];
+                    for (let period = 1; period < 9; period++) {
+                        const o = origin[weekday][period];
+                        const t = today[weekday][period];
+                        if (!o || !t) {
+                            weekdayList.push({
+                                "subject": "-",
+                                "teacher": "-"
+                            });
+                            continue;
+                        }
+                        const originSubject = json.과목명[this.mSb(o, sep) % sep];
+                        const originTeacher = json.성명[this.mTh(o, sep) % sep];
+                        if (o === t) {
+                            weekdayList.push({
+                                "subject": originSubject,
+                                "teacher": originTeacher
+                            });
+                            continue;
+                        }
+                        const changedSubject = json.과목명[this.mSb(t, sep) % sep];
+                        const changedTeacher = json.성명[this.mTh(t, sep) % sep];
+                        weekdayList.push({
+                            "subject": originSubject,
+                            "teacher": originTeacher,
+                            "replacedFrom": {
+                                "subject": changedSubject,
+                                "teacher": changedTeacher
+                            }
+                        });
+                    }
+                    toReturn.push(weekdayList);
+                }
+            }
+            else {
+                for (let period = 1; period < 9; period++) {
+                    const periodList = [];
+                    for (let weekday = 1; weekday < WEEKDAY.length + 1; weekday++) {
+                        const o = origin[weekday][period];
+                        const t = today[weekday][period];
+                        if (!o || !t) {
+                            periodList.push({
+                                "subject": "-",
+                                "teacher": "-"
+                            });
+                            continue;
+                        }
+                        const originSubject = json.과목명[this.mSb(o, sep) % sep];
+                        const originTeacher = json.성명[this.mTh(o, sep) % sep];
+                        if (o === t) {
+                            periodList.push({
+                                "subject": originSubject,
+                                "teacher": originTeacher
+                            });
+                            continue;
+                        }
+                        const changedSubject = json.과목명[this.mSb(t, sep) % sep];
+                        const changedTeacher = json.성명[this.mTh(t, sep) % sep];
+                        periodList.push({
+                            "subject": originSubject,
+                            "teacher": originTeacher,
+                            "replacedFrom": {
+                                "subject": changedSubject,
+                                "teacher": changedTeacher
+                            }
+                        });
+                    }
+                    toReturn.push(periodList);
+                }
+            }
+            return {
+                "changedWhen": edited,
+                latestVersion,
+                "timetable": toReturn
+            };
+        });
+    }
+    /**
+     * 학급 목록을 가져옵니다.
+     *
+     * @param schoolCode 학교 코드입니다.
+     * @returns (학년)-(반) 문자열이 모인 배열
+     */
+    GetClassList(schoolCode) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const str = `36174_${schoolCode}_1_4_0_3_1.00`;
+            const route = (str.substring(9) + str.substring(0, 9)).split("").reverse().join("");
+            const data = yield this.request(`7813?${route}`, true);
+            const step1 = data.split("^")[1];
+            const step2 = step1.slice(step1.indexOf("{"));
+            const json = JSON.parse(step2.slice(0, step2.indexOf("}") + 1));
+            const rawClasses = json.학급수;
+            const toReturn = [];
+            for (let g = 1; g < rawClasses.length; g++) {
+                for (let c = 1; c < rawClasses[g] + 1; c++) {
+                    toReturn.push(`${g}-${c}`);
+                }
+            }
+            return toReturn;
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "parse-comcigan",
+  "version": "0.0.1",
+  "description": "컴시간 알리미에서 시간표를 가져오는 라이브러리입니다.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Pro203S",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "pack": "npm run clean && npm run build",
+    "build": "tsc",
+    "clean": "tsc --build --clean",
+    "dev": "nodemon --exec ts-node src/index.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.1",
+    "nodemon": "^3.1.9",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "axios": "^1.8.4",
+    "iconv-lite": "^0.6.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,367 @@
+import axios from 'axios';
+import iconv from 'iconv-lite';
+
+class Cache {
+    private _cacheStorage: {
+        [id: string]: {
+            "timeout": NodeJS.Timeout;
+            "data": any;
+        }
+    } = {};
+
+    public register(id: string, data: any, duration: number) {
+        this._cacheStorage[id] = {
+            "timeout": setTimeout(() => {
+                delete this._cacheStorage[id];
+            }, duration),
+            "data": data
+        };
+    }
+    public delete(id: string) {
+        clearTimeout(this._cacheStorage[id].timeout);
+        delete this._cacheStorage[id];
+    }
+    public clear() {
+        const caches = Object.keys(this._cacheStorage);
+        for (let cache of caches) {
+            clearTimeout(this._cacheStorage[cache].timeout);
+            delete this._cacheStorage[cache];
+        }
+    }
+    public has(id: string) {
+        return Boolean(this._cacheStorage[id]);
+    }
+    public get(id: string) {
+        return this._cacheStorage[id]?.data;
+    }
+}
+
+//#region 내부 타입
+type RawComciganSearched = {
+    "학교검색": [
+        number,
+        string,
+        string,
+        number
+    ][];
+};
+type RawComciganTimetable = {
+    교사수: number;
+    성명: string[];
+    학급수: number[];
+    요일별시수: number[][];
+    과목명: any[];
+    시간표: any;
+    전일제: number[];
+    버젼: string;
+    동시수업수: number;
+    담임: number[][];
+    가상학급수: number[];
+    특별실수: number;
+    열람제한일: string;
+    저장일: string;
+    학기시작일자: string;
+    학교명: string;
+    지역명: string;
+    학년도: number;
+    분리?: number;
+    강의실: number;
+    시작일: string;
+    일과시간: string[];
+    일자자료: [number, string][];
+    오늘r: number;
+    학급시간표: any;
+    교사시간표: any[];
+    강의실시간표: any;
+    동시그룹: number[][];
+    컴시간?: string;
+};
+//#endregion
+
+//#region 외부 타입
+export interface ComciganInitializeType {
+    /**
+     * 이 기간동안 컴시간과 통신한 데이터가 캐시됩니다.  
+     *   
+     * 기본값은 0ms이며, 0ms일때는 캐시를 하지 않습니다.
+     */
+    cacheMs?: number;
+    /**
+     * axios에서 요청을 보내고 status가 오류 status일 때 throw할 지 여부입니다.  
+     * 만약 false일 때 요청에 status가 오류 status면 그 타입에서 빈 값을 리턴합니다.
+     *   
+     * 기본값은 false입니다.
+     */
+    doNotThrow?: boolean;
+    /**
+     * 디버그 메시지를 파라메터로 받습니다.  
+     *   
+     * 기본값은 없습니다.
+     */
+    debug?: (msg: string) => any;
+}
+export type ComciganSearched = {
+    /**
+     * 학교의 지역입니다.
+     */
+    region: string;
+    /**
+     * 학교의 이름입니다.
+     */
+    name: string;
+    /**
+     * 학교의 코드입니다.
+     */
+    code: number;
+};
+export type ComciganTimetableObject = {
+    /**
+     * 과목입니다.
+     */
+    subject: string;
+    /**
+     * 교사 성명입니다.
+     */
+    teacher: string;
+    /**
+     * 만약 변경되었을때 이 값이 주어집니다.
+     */
+    original?: {
+        /**
+         * 과목입니다.
+         */
+        subject: string;
+        /**
+         * 교사 성명입니다.
+         */
+        teacher: string;
+    }
+};
+export type ComciganTimetable = {
+    /**
+     * 컴시간알리미 앱의 최신 버전입니다.
+     */
+    latestVersion: string;
+    /**
+     * 수정일입니다.
+     */
+    changed: string;
+    /**
+     * 시간표입니다.
+     */
+    timetable: ComciganTimetableObject[][];
+};
+//#endregion
+
+export default class Comcigan {
+    private _options: ComciganInitializeType = {
+        "cacheMs": 0,
+        "doNotThrow": false
+    };
+    private _cache = new Cache();
+
+    private mSb(mm: number, m2: number) { if (m2 == 100) { return mm % m2; } return Math.floor(mm / m2); }
+    private mTh(mm: number, m2: number) { if (m2 == 100) { return Math.floor(mm / m2); } return mm % m2; }
+
+    private async request<T = any>(route: string, doNotParse?: boolean): Promise<T> {
+        if (this._cache.has(route)) {
+            this._options.debug ? this._options.debug(`[request] Return cache with id registered as ${route}`) : 0;
+            return this._cache.get(route);
+        }
+
+        this._options.debug ? this._options.debug(`[request] Requesting to http://comci.kr:4081/${route}`) : 0;
+        const r = await axios.get<any>(`http://comci.kr:4081/${route}`, {
+            ...(this._options.doNotThrow && { "validateStatus": () => true })
+        });
+
+        if (doNotParse) {
+            if (this._options.cacheMs && this._options.cacheMs !== 0) {
+                this._options.debug ? this._options.debug(`[request] Registered cache with id ${route}`) : 0;
+                this._cache.register(route, r.data, this._options.cacheMs);
+            }
+            return r.data;
+        }
+
+        const data = JSON.parse(r.data.slice(0, r.data.indexOf("}") + 1));
+        if (this._options.cacheMs && this._options.cacheMs !== 0) {
+            this._options.debug ? this._options.debug(`[request] Registered cache with id ${route}`) : 0;
+            this._cache.register(route, data, this._options.cacheMs);
+        }
+        return data;
+    }
+
+    private EUC_KR_encodeURI(str: string): string {
+        const buffer = iconv.encode(str, 'euc-kr');
+        return Array.from(buffer)
+            .map((byte) => '%' + byte.toString(16).toUpperCase().padStart(2, '0'))
+            .join('');
+    }
+
+    /**
+     * 파서를 초기화 합니다.
+     * @param options 파서의 옵션입니다.
+     */
+    constructor(options?: ComciganInitializeType) {
+        this._options = {
+            ...this._options,
+            ...options
+        };
+    }
+
+    /**
+     * 학교를 검색합니다.  
+     * 마지막 "없으면 추가 검색 하세요" 문구는 빠져서 나옵니다.  
+     * @param query 검색어
+     * @returns 검색된 학교들
+     */
+    public async SearchSchool(query: string): Promise<ComciganSearched[]> {
+        const r = await this.request<RawComciganSearched>(`sc_${this.EUC_KR_encodeURI(query)}`);
+
+        return r.학교검색.map(v => ({
+            "region": v[1],
+            "name": v[2],
+            "code": v[3]
+        })).filter(v => v.code !== 0);
+    }
+
+    /**
+     * 시간표를 가져옵니다.
+     * 
+     * @param schoolCode 
+     * @param criteria 
+     */
+    public async GetTimetable(schoolCode: number, criteria: "weekday" | "period", grade: number, classN: number): Promise<ComciganTimetable> {
+        const str = `36174_${schoolCode}_1_4_0_3_1.00`;
+        const route = (str.substring(9) + str.substring(0, 9)).split("").reverse().join("");
+        const data = await this.request<string>(`7813?${route}`, true);
+
+        const [latestVersion, step1] = data.split("^");
+        const edited = step1.substring(0, step1.indexOf("{"));
+        const step2 = step1.slice(step1.indexOf("{"));
+        const json: RawComciganTimetable = JSON.parse(step2.slice(0, step2.indexOf("}") + 1));
+
+        const WEEKDAY = ["월", "화", "수", "목", "금"];
+        const sep = json.분리 ?? 100;
+
+        // 시간표[학년][반][요일][교시]
+        const origin = json.시간표[grade][classN];
+        const today = json.학급시간표[grade][classN];
+
+        const toReturn: ComciganTimetableObject[][] = [];
+
+        if (criteria === "period") {
+            for (let weekday = 1; weekday < WEEKDAY.length + 1; weekday++) {
+                const weekdayList: ComciganTimetableObject[] = [];
+                for (let period = 1; period < 9; period++) {
+                    const o = origin[weekday][period];
+                    const t = today[weekday][period];
+
+                    if (!o || !t) {
+                        weekdayList.push({
+                            "subject": "-",
+                            "teacher": "-"
+                        });
+                        continue;
+                    }
+
+                    const originSubject = json.과목명[this.mSb(o, sep) % sep];
+                    const originTeacher = json.성명[this.mTh(o, sep) % sep];
+
+                    if (o === t) {
+                        weekdayList.push({
+                            "subject": originSubject,
+                            "teacher": originTeacher
+                        });
+                        continue;
+                    }
+
+                    const changedSubject = json.과목명[this.mSb(t, sep) % sep];
+                    const changedTeacher = json.성명[this.mTh(t, sep) % sep];
+
+                    weekdayList.push({
+                        "subject": originSubject,
+                        "teacher": originTeacher,
+                        "original": {
+                            "subject": changedSubject,
+                            "teacher": changedTeacher
+                        }
+                    });
+                }
+                toReturn.push(weekdayList);
+            }
+        } else {
+            for (let period = 1; period < 9; period++) {
+                const periodList: ComciganTimetableObject[] = [];
+                for (let weekday = 1; weekday < WEEKDAY.length + 1; weekday++) {
+                    const o = origin[weekday][period];
+                    const t = today[weekday][period];
+
+                    if (!o || !t) {
+                        periodList.push({
+                            "subject": "-",
+                            "teacher": "-"
+                        });
+                        continue;
+                    }
+
+                    const originSubject = json.과목명[this.mSb(o, sep) % sep];
+                    const originTeacher = json.성명[this.mTh(o, sep) % sep];
+
+                    if (o === t) {
+                        periodList.push({
+                            "subject": originSubject,
+                            "teacher": originTeacher
+                        });
+                        continue;
+                    }
+
+                    const changedSubject = json.과목명[this.mSb(t, sep) % sep];
+                    const changedTeacher = json.성명[this.mTh(t, sep) % sep];
+
+                    periodList.push({
+                        "subject": originSubject,
+                        "teacher": originTeacher,
+                        "original": {
+                            "subject": changedSubject,
+                            "teacher": changedTeacher
+                        }
+                    });
+                }
+                toReturn.push(periodList);
+            }
+        }
+
+        return {
+            "changed": edited,
+            latestVersion,
+            "timetable": toReturn
+        };
+    }
+
+    /**
+     * 학급 목록을 가져옵니다.
+     * 
+     * @param schoolCode 학교 코드입니다.
+     * @returns (학년)-(반) 문자열이 모인 배열
+     */
+    public async GetClassList(schoolCode: number): Promise<string[]> {
+        const str = `36174_${schoolCode}_1_4_0_3_1.00`;
+        const route = (str.substring(9) + str.substring(0, 9)).split("").reverse().join("");
+        const data = await this.request<string>(`7813?${route}`, true);
+
+        const step1 = data.split("^")[1];
+        const step2 = step1.slice(step1.indexOf("{"));
+        const json: RawComciganTimetable = JSON.parse(step2.slice(0, step2.indexOf("}") + 1));
+        const rawClasses = json.학급수;
+        
+        const toReturn: string[] = [];
+        
+        for (let g = 1; g < rawClasses.length; g++) {
+            for (let c = 1; c < rawClasses[g] + 1; c++) {
+                toReturn.push(`${g}-${c}`);
+            }
+        }
+
+        return toReturn;
+    }
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "outDir": "dist",
+    "target": "ES6",
+    "module": "ESNext",
+    "lib": [
+      "ES6",
+      "DOM"
+    ],
+    "moduleResolution": "Node",
+    "esModuleInterop": true,
+    "declaration": true,
+    "strict": true,
+    "sourceMap": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}