chukyo-sdk 0.1.0

package/dist/esm/cubics/parser/cubics.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CUBICS（教務システム）週間時間割ページのパーサ。
+ * 画面遷移型の HTML で、値は hidden input に格納されている。
+ */
+import type { ZodSafeParseResult } from "zod";
+import { type CubicsAsTimetableDTO } from "../types/cubics";
+export declare const parseCubicsAsTimetable: (html: string) => ZodSafeParseResult<CubicsAsTimetableDTO>;
+//# sourceMappingURL=cubics.d.ts.map

package/dist/esm/cubics/parser/cubics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubics.d.ts","sourceRoot":"","sources":["../../../../src/cubics/parser/cubics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,KAAK,CAAC;AAI9C,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAcrF,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,KAAG,kBAAkB,CAAC,oBAAoB,CAyG5F,CAAC"}

package/dist/esm/cubics/parser/cubics.js

@@ -0,0 +1,99 @@
+import { getAttribute, getInnerHtml, getTextContent, loadDocument, queryAll, queryOne } from "../../common/dom";
+import { extractFirstQuotedValue, normalizeWhitespace } from "../../common/utils";
+import { CubicsAsTimetableSchema } from "../types/cubics";
+const BR_PATTERN = /<br\s*\/?\s*>/gi;
+const emptyOrNull = (value) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return value.length > 0 ? value : null;
+};
+const getInputValue = (selector, root) => emptyOrNull(getAttribute(queryOne(selector, root), "value"));
+export const parseCubicsAsTimetable = (html) => {
+    const document = loadDocument(html);
+    // --- 学生情報（table.output） ---
+    const studentTable = queryOne("table.output", document);
+    const studentRows = studentTable ? queryAll("tr", studentTable) : [];
+    const row1Cells = studentRows[0] ? queryAll("td", studentRows[0]) : [];
+    const row2Cells = studentRows[1] ? queryAll("td", studentRows[1]) : [];
+    const row3Cells = studentRows[2] ? queryAll("td", studentRows[2]) : [];
+    const row4Cells = studentRows[3] ? queryAll("td", studentRows[3]) : [];
+    const getCellText = (cells, index) => normalizeWhitespace(getTextContent(cells[index] ?? null));
+    // 氏名セルは "日本語氏名<BR />(ALPHABET NAME)" 形式。<BR> で分割し、後半の括弧を除去する。
+    const nameCellHtml = getInnerHtml(row1Cells[1] ?? null);
+    const nameParts = nameCellHtml.split(BR_PATTERN);
+    const name = normalizeWhitespace(getTextContent(loadDocument(nameParts[0] ?? "")));
+    const alphabetRaw = normalizeWhitespace(getTextContent(loadDocument(nameParts[1] ?? "")));
+    const alphabetInner = alphabetRaw.replace(/^\(/, "").replace(/\)$/, "");
+    const nameAlphabet = emptyOrNull(normalizeWhitespace(alphabetInner));
+    const student = {
+        id: getCellText(row1Cells, 0),
+        name,
+        nameAlphabet,
+        division: getCellText(row2Cells, 0),
+        affiliation: getCellText(row2Cells, 1),
+        status: getCellText(row2Cells, 2),
+        className: getCellText(row2Cells, 3),
+        faculty: getCellText(row3Cells, 0),
+        department: getCellText(row3Cells, 1),
+        course: getCellText(row3Cells, 2),
+        address: getCellText(row4Cells, 0),
+    };
+    // --- 表示期間 ---
+    const periodInput = queryOne("input[name='lblSpcfProd']", document);
+    const periodRange = normalizeWhitespace(getAttribute(periodInput, "value") ?? "");
+    // --- 時間割表（table.output_curriculum） ---
+    const curriculumTable = queryOne("table.output_curriculum", document);
+    const headerRow = curriculumTable ? queryOne("tr", curriculumTable) : null;
+    const headerCells = headerRow ? queryAll("th", headerRow).slice(1) : [];
+    const days = headerCells.map((element) => {
+        // input[name$=".lblLsnDt"] の value は "月<BR/>06/16"（属性値なのでエンティティは復号済み）。
+        const raw = getAttribute(queryOne('input[name$=".lblLsnDt"]', element), "value");
+        const parts = (raw ?? "").split(BR_PATTERN).map((part) => normalizeWhitespace(part));
+        return {
+            weekday: parts[0] ?? "",
+            date: parts[1] ?? "",
+        };
+    });
+    const periodRows = curriculumTable ? queryAll("tr", curriculumTable).slice(1) : [];
+    const periods = periodRows.map((row) => {
+        const periodLabel = normalizeWhitespace(getTextContent(queryOne("th", row)));
+        const cells = queryAll("td", row);
+        const slots = cells.map((cell) => {
+            const lessonCode = getInputValue('input[name$=".hdnLsnCd1"]', cell);
+            const lessonYear = getInputValue('input[name$=".hdnLsnOpcFcy1"]', cell);
+            const termCode = getInputValue('input[name$=".hdnTacTrmCd1"]', cell);
+            const timetableCode = getInputValue('input[name$=".hdnTmtxCd"]', cell);
+            const lessonDate = getInputValue('input[name$=".hdnOpcDt"]', cell);
+            // 科目名: hdnSbjKnjNm（完全名称）を優先し、空なら lblSbjKnjNm（表示名称）へフォールバック。
+            const subject = getInputValue('input[name$=".hdnSbjKnjNm"]', cell) ?? getInputValue('input[name$=".lblSbjKnjNm"]', cell);
+            // 教室名: hdnClrNm の <BR/> を半角スペースへ。空なら lblClrNm へフォールバック。
+            const classroomFull = getAttribute(queryOne('input[name$=".hdnClrNm"]', cell), "value");
+            const classroomNormalized = emptyOrNull(normalizeWhitespace((classroomFull ?? "").replace(BR_PATTERN, " ")));
+            const classroom = classroomNormalized ?? getInputValue('input[name$=".lblClrNm"]', cell);
+            // 詳細URL: execPopupWindowOpen(...) を含む onclick の最初のシングルクォート引数。
+            const detailAnchor = queryAll("a", cell).find((anchor) => (getAttribute(anchor, "onclick") ?? "").includes("execPopupWindowOpen"));
+            const detailUrl = extractFirstQuotedValue(detailAnchor ? getAttribute(detailAnchor, "onclick") : null);
+            // ステータスアイコン: img の src で判定。
+            const iconSources = queryAll("img", cell).map((img) => getAttribute(img, "src") ?? "");
+            const isCancelled = iconSources.some((src) => src.includes("icon_kyukou"));
+            const isSupplementary = iconSources.some((src) => src.includes("icon_hokou"));
+            const isChanged = iconSources.some((src) => src.includes("icon_jyugyouhenkou"));
+            return {
+                subject,
+                classroom,
+                lessonCode,
+                lessonYear,
+                termCode,
+                timetableCode,
+                lessonDate,
+                detailUrl,
+                isCancelled,
+                isSupplementary,
+                isChanged,
+            };
+        });
+        return { periodLabel, slots };
+    });
+    return CubicsAsTimetableSchema.safeParse({ student, periodRange, days, periods });
+};

package/dist/esm/cubics/types/cubics.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+/** CUBICS 時間割の1コマ（空きコマは文字列フィールドが null / フラグが false） */
+export declare const CubicsAsTimetableSlotSchema: z.ZodObject<{
+    subject: z.ZodNullable<z.ZodString>;
+    classroom: z.ZodNullable<z.ZodString>;
+    lessonCode: z.ZodNullable<z.ZodString>;
+    lessonYear: z.ZodNullable<z.ZodString>;
+    termCode: z.ZodNullable<z.ZodString>;
+    timetableCode: z.ZodNullable<z.ZodString>;
+    lessonDate: z.ZodNullable<z.ZodString>;
+    detailUrl: z.ZodNullable<z.ZodString>;
+    isCancelled: z.ZodBoolean;
+    isSupplementary: z.ZodBoolean;
+    isChanged: z.ZodBoolean;
+}, z.core.$strip>;
+export type CubicsAsTimetableSlotDTO = z.infer<typeof CubicsAsTimetableSlotSchema>;
+/** 1時限分の行（曜日順のコマ配列） */
+export declare const CubicsAsTimetablePeriodSchema: z.ZodObject<{
+    periodLabel: z.ZodString;
+    slots: z.ZodArray<z.ZodObject<{
+        subject: z.ZodNullable<z.ZodString>;
+        classroom: z.ZodNullable<z.ZodString>;
+        lessonCode: z.ZodNullable<z.ZodString>;
+        lessonYear: z.ZodNullable<z.ZodString>;
+        termCode: z.ZodNullable<z.ZodString>;
+        timetableCode: z.ZodNullable<z.ZodString>;
+        lessonDate: z.ZodNullable<z.ZodString>;
+        detailUrl: z.ZodNullable<z.ZodString>;
+        isCancelled: z.ZodBoolean;
+        isSupplementary: z.ZodBoolean;
+        isChanged: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CubicsAsTimetablePeriodDTO = z.infer<typeof CubicsAsTimetablePeriodSchema>;
+/** 時間割表ヘッダの1日分 */
+export declare const CubicsAsTimetableDaySchema: z.ZodObject<{
+    weekday: z.ZodString;
+    date: z.ZodString;
+}, z.core.$strip>;
+export type CubicsAsTimetableDayDTO = z.infer<typeof CubicsAsTimetableDaySchema>;
+/** 学生情報ブロック（PII を含む） */
+export declare const CubicsAsTimetableStudentSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    nameAlphabet: z.ZodNullable<z.ZodString>;
+    division: z.ZodString;
+    affiliation: z.ZodString;
+    status: z.ZodString;
+    className: z.ZodString;
+    faculty: z.ZodString;
+    department: z.ZodString;
+    course: z.ZodString;
+    address: z.ZodString;
+}, z.core.$strip>;
+export type CubicsAsTimetableStudentDTO = z.infer<typeof CubicsAsTimetableStudentSchema>;
+/** CUBICS 週間時間割（学生情報 + 表示期間 + 曜日ヘッダ + 時限×コマ） */
+export declare const CubicsAsTimetableSchema: z.ZodObject<{
+    student: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        nameAlphabet: z.ZodNullable<z.ZodString>;
+        division: z.ZodString;
+        affiliation: z.ZodString;
+        status: z.ZodString;
+        className: z.ZodString;
+        faculty: z.ZodString;
+        department: z.ZodString;
+        course: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strip>;
+    periodRange: z.ZodString;
+    days: z.ZodArray<z.ZodObject<{
+        weekday: z.ZodString;
+        date: z.ZodString;
+    }, z.core.$strip>>;
+    periods: z.ZodArray<z.ZodObject<{
+        periodLabel: z.ZodString;
+        slots: z.ZodArray<z.ZodObject<{
+            subject: z.ZodNullable<z.ZodString>;
+            classroom: z.ZodNullable<z.ZodString>;
+            lessonCode: z.ZodNullable<z.ZodString>;
+            lessonYear: z.ZodNullable<z.ZodString>;
+            termCode: z.ZodNullable<z.ZodString>;
+            timetableCode: z.ZodNullable<z.ZodString>;
+            lessonDate: z.ZodNullable<z.ZodString>;
+            detailUrl: z.ZodNullable<z.ZodString>;
+            isCancelled: z.ZodBoolean;
+            isSupplementary: z.ZodBoolean;
+            isChanged: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CubicsAsTimetableDTO = z.infer<typeof CubicsAsTimetableSchema>;
+//# sourceMappingURL=cubics.d.ts.map

package/dist/esm/cubics/types/cubics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubics.d.ts","sourceRoot":"","sources":["../../../../src/cubics/types/cubics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uDAAuD;AACvD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBA6BtC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEnF,uBAAuB;AACvB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;iBAKxC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEvF,kBAAkB;AAClB,eAAO,MAAM,0BAA0B;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEjF,wBAAwB;AACxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;iBA4BzC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEzF,gDAAgD;AAChD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASlC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/cubics/types/cubics.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+/** CUBICS 時間割の1コマ（空きコマは文字列フィールドが null / フラグが false） */
+export const CubicsAsTimetableSlotSchema = z.object({
+    /** 科目名（正式名称） @example "情報リテラシー" */
+    subject: z
+        .string()
+        .nullable()
+        .meta({ description: "科目名（正式名称。hdnSbjKnjNm から復元）", example: "情報リテラシー" }),
+    /** 教室名（複数教室は半角スペース区切り） @example "1731 1732" */
+    classroom: z.string().nullable().meta({ description: "教室名（複数は半角スペース区切り）", example: "1731 1732" }),
+    /** 授業コード（hdnLsnCd1） @example "12345" */
+    lessonCode: z.string().nullable().meta({ description: "授業コード（hdnLsnCd1）", example: "12345" }),
+    /** 開講年度（hdnLsnOpcFcy1） @example "2025" */
+    lessonYear: z.string().nullable().meta({ description: "開講年度（hdnLsnOpcFcy1）", example: "2025" }),
+    /** 学期コード（hdnTacTrmCd1） @example "01" */
+    termCode: z.string().nullable().meta({ description: "学期コード（hdnTacTrmCd1）", example: "01" }),
+    /** 時間割コード（hdnTmtxCd） @example "A1" */
+    timetableCode: z.string().nullable().meta({ description: "時間割コード（hdnTmtxCd）", example: "A1" }),
+    /** 開講日（hdnOpcDt。yyyymmdd） @example "20250616" */
+    lessonDate: z.string().nullable().meta({ description: "開講日（hdnOpcDt。yyyymmdd）", example: "20250616" }),
+    /** 授業詳細ポップアップの URL（onclick から抽出） @example "/unias/ARF010Popup.do?..." */
+    detailUrl: z
+        .string()
+        .nullable()
+        .meta({ description: "授業詳細ポップアップの URL", example: "/unias/ARF010Popup.do?..." }),
+    /** 休講フラグ（icon_kyukou） @example false */
+    isCancelled: z.boolean().meta({ description: "休講（icon_kyukou）", example: false }),
+    /** 補講フラグ（icon_hokou） @example false */
+    isSupplementary: z.boolean().meta({ description: "補講（icon_hokou）", example: false }),
+    /** 授業変更フラグ（icon_jyugyouhenkou） @example false */
+    isChanged: z.boolean().meta({ description: "授業変更（icon_jyugyouhenkou）", example: false }),
+});
+/** 1時限分の行（曜日順のコマ配列） */
+export const CubicsAsTimetablePeriodSchema = z.object({
+    /** 時限ラベル @example "1時限" */
+    periodLabel: z.string().meta({ description: "時限ラベル", example: "1時限" }),
+    /** 曜日順のスロット。空きコマは全フィールド null / false */
+    slots: z.array(CubicsAsTimetableSlotSchema).meta({ description: "曜日順のスロット" }),
+});
+/** 時間割表ヘッダの1日分 */
+export const CubicsAsTimetableDaySchema = z.object({
+    /** 曜日 @example "月" */
+    weekday: z.string().meta({ description: "曜日", example: "月" }),
+    /** 日付（MM/DD） @example "06/16" */
+    date: z.string().meta({ description: "日付（MM/DD）", example: "06/16" }),
+});
+/** 学生情報ブロック（PII を含む） */
+export const CubicsAsTimetableStudentSchema = z.object({
+    /** 学籍番号 @example "T000000" */
+    id: z.string().meta({ description: "学籍番号", example: "T000000" }),
+    /** 氏名（日本語表記） @example "田中太郎" */
+    name: z.string().meta({ description: "氏名（日本語表記）", example: "田中太郎" }),
+    /** 氏名（アルファベット表記。取得不可なら null） @example "TANAKA TARO" */
+    nameAlphabet: z
+        .string()
+        .nullable()
+        .meta({ description: "氏名（アルファベット表記）", example: "TANAKA TARO" }),
+    /** 学生区分 @example "学部（正規）" */
+    division: z.string().meta({ description: "学生区分", example: "学部（正規）" }),
+    /** 所属区分 @example "学部生" */
+    affiliation: z.string().meta({ description: "所属区分", example: "学部生" }),
+    /** 学生状態 @example "在学" */
+    status: z.string().meta({ description: "学生状態", example: "在学" }),
+    /** クラス @example "F" */
+    className: z.string().meta({ description: "クラス", example: "F" }),
+    /** 学部 @example "工学部" */
+    faculty: z.string().meta({ description: "学部", example: "工学部" }),
+    /** 学科 @example "情報工学科" */
+    department: z.string().meta({ description: "学科", example: "情報工学科" }),
+    /** コース @example "メディア工学コース" */
+    course: z.string().meta({ description: "コース", example: "メディア工学コース" }),
+    /** 住所・電話番号（固定）（携帯）の結合文字列 @example "愛知県名古屋市... 052-000-0000 090-0000-0000" */
+    address: z
+        .string()
+        .meta({ description: "住所・電話番号の結合文字列", example: "愛知県名古屋市... 052-000-0000 090-0000-0000" }),
+});
+/** CUBICS 週間時間割（学生情報 + 表示期間 + 曜日ヘッダ + 時限×コマ） */
+export const CubicsAsTimetableSchema = z.object({
+    /** 学生情報 */
+    student: CubicsAsTimetableStudentSchema,
+    /** 表示期間 @example "2025年06月16日～2025年06月21日" */
+    periodRange: z.string().meta({ description: "表示期間", example: "2025年06月16日～2025年06月21日" }),
+    /** 曜日ヘッダ */
+    days: z.array(CubicsAsTimetableDaySchema).meta({ description: "曜日ヘッダ" }),
+    /** 時限ごとの行 */
+    periods: z.array(CubicsAsTimetablePeriodSchema).meta({ description: "時限ごとの行" }),
+});

package/dist/esm/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SDK が投げるエラー型。呼び出し側はこれらを `instanceof` で判別してハンドリングする。
+ */
+/** すべての SDK エラーの基底 */
+export declare class ChukyoSdkError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * パース失敗。fetch は成功したがレスポンスが期待スキーマに一致しなかった場合。
+ * `cause` に Zod のエラーが入る（サイトの HTML/JSON 構造変化の疑い）。
+ */
+export declare class ParseError extends ChukyoSdkError {
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * セッション失効。Cookie が無効で、再認証を試みても回復しなかった場合。
+ * CUBICS のように画面遷移型でセッションが不安定なサービスで発生しうる。
+ */
+export declare class ExpiredSessionError extends ChukyoSdkError {
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+/** 大学側メンテナンス（HTTP 503）。UI 側で案内を出すために区別する。 */
+export declare class ChukyoMaintenanceError extends ChukyoSdkError {
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+/** ネットワーク到達失敗（DNS・接続拒否・TLS 等、HTTP レスポンスを受け取れていない）。 */
+export declare class NetworkError extends ChukyoSdkError {
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+/** リクエストがタイムアウトした。 */
+export declare class TimeoutError extends ChukyoSdkError {
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sBAAsB;AACtB,qBAAa,cAAe,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI7D;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,cAAc;gBAC9B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACvC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5C;AAED,6CAA6C;AAC7C,qBAAa,sBAAuB,SAAQ,cAAc;gBAC1C,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5C;AAED,sDAAsD;AACtD,qBAAa,YAAa,SAAQ,cAAc;gBAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5C;AAED,sBAAsB;AACtB,qBAAa,YAAa,SAAQ,cAAc;gBAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5C"}

package/dist/esm/errors.js

@@ -0,0 +1,46 @@
+/**
+ * SDK が投げるエラー型。呼び出し側はこれらを `instanceof` で判別してハンドリングする。
+ */
+/** すべての SDK エラーの基底 */
+export class ChukyoSdkError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+/**
+ * パース失敗。fetch は成功したがレスポンスが期待スキーマに一致しなかった場合。
+ * `cause` に Zod のエラーが入る（サイトの HTML/JSON 構造変化の疑い）。
+ */
+export class ParseError extends ChukyoSdkError {
+    constructor(options) {
+        super("レスポンスのパースに失敗しました", options);
+    }
+}
+/**
+ * セッション失効。Cookie が無効で、再認証を試みても回復しなかった場合。
+ * CUBICS のように画面遷移型でセッションが不安定なサービスで発生しうる。
+ */
+export class ExpiredSessionError extends ChukyoSdkError {
+    constructor(options) {
+        super("ポータルのセッションが失効しています", options);
+    }
+}
+/** 大学側メンテナンス（HTTP 503）。UI 側で案内を出すために区別する。 */
+export class ChukyoMaintenanceError extends ChukyoSdkError {
+    constructor(options) {
+        super("中京大学ポータルがメンテナンス中です", options);
+    }
+}
+/** ネットワーク到達失敗（DNS・接続拒否・TLS 等、HTTP レスポンスを受け取れていない）。 */
+export class NetworkError extends ChukyoSdkError {
+    constructor(options) {
+        super("ネットワークエラーが発生しました", options);
+    }
+}
+/** リクエストがタイムアウトした。 */
+export class TimeoutError extends ChukyoSdkError {
+    constructor(options) {
+        super("リクエストがタイムアウトしました", options);
+    }
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,19 @@
+import type { ChukyoClientOptions } from "./types";
+import { CubicsClient } from "./cubics/client";
+import { AlboClient } from "./albo/client";
+import { ManaboClient } from "./manabo/client";
+export interface ChukyoClient {
+    readonly cubics: CubicsClient;
+    readonly albo: AlboClient;
+    readonly manabo: ManaboClient;
+}
+/** SDK クライアントを生成する。 */
+export declare const createChukyoClient: (options: ChukyoClientOptions) => ChukyoClient;
+export type { Transport, TransportRequest, TransportResponse, SessionProvider, PortalService, ChukyoClientOptions, } from "./types";
+export { ChukyoSdkError, ParseError, ExpiredSessionError, ChukyoMaintenanceError, NetworkError, TimeoutError, } from "./errors";
+export { fetchTransport, type FetchTransportOptions } from "./transports/fetch";
+export * from "./cubics/index";
+export * from "./albo/index";
+export * from "./manabo/index";
+export * from "./shib/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CACjC;AAED,uBAAuB;AACvB,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KAAG,YAUjE,CAAC;AAGF,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,mBAAmB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,YAAY,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,25 @@
+import { CubicsClient } from "./cubics/client";
+import { AlboClient } from "./albo/client";
+import { ManaboClient } from "./manabo/client";
+/** SDK クライアントを生成する。 */
+export const createChukyoClient = (options) => {
+    const ctx = {
+        transport: options.transport,
+        ...(options.session ? { session: options.session } : {}),
+    };
+    return {
+        cubics: new CubicsClient(ctx),
+        albo: new AlboClient(ctx),
+        manabo: new ManaboClient(ctx),
+    };
+};
+// ---- エラー ----
+export { ChukyoSdkError, ParseError, ExpiredSessionError, ChukyoMaintenanceError, NetworkError, TimeoutError, } from "./errors";
+// ---- Transport Adapter ----
+export { fetchTransport } from "./transports/fetch";
+// ---- ポータル別 parser / 型 / クライアント ----
+export * from "./cubics/index";
+export * from "./albo/index";
+export * from "./manabo/index";
+// ---- 認証フロー（Shibboleth）の構造化ヘルパ（実行はしない） ----
+export * from "./shib/index";

package/dist/esm/manabo/client.d.ts

@@ -0,0 +1,75 @@
+import { type RequestContext } from "../core/request";
+import type { ManaboClassContentDTO, ManaboClassDirectoryDTO, ManaboClassEntryDTO, ManaboClassNewsDTO, ManaboClassSyllabusDTO } from "./types/manaboClass";
+import type { ManaboEntryFormDTO, ManaboEntryResponseDTO } from "./types/manaboEntry";
+import type { ManaboMailMemberDTO, ManaboMailViewDTO, ManaboReceivedMailDTO, ManaboSentMailDTO } from "./types/manaboMail";
+import type { ManaboTimetableDTO } from "./types/manaboTimetable";
+export declare class ManaboClient {
+    private readonly ctx;
+    constructor(ctx: RequestContext);
+    private fetchText;
+    /** トップページに `action=...` を POST して HTML 断片を得る */
+    private postAction;
+    /** 時間割を取得する */
+    getTimetable(): Promise<ManaboTimetableDTO>;
+    /** 授業のお知らせ一覧を取得する */
+    getClassNews(classId: string): Promise<ManaboClassNewsDTO>;
+    /** 授業のシラバスを取得する */
+    getClassSyllabus(classId: string): Promise<ManaboClassSyllabusDTO>;
+    /** 授業の出席表（各回の出欠一覧）を取得する */
+    getClassEntry(classId: string): Promise<ManaboClassEntryDTO>;
+    /** 授業のディレクトリ（週・回）一覧を取得する */
+    getClassDirectory(classId: string): Promise<ManaboClassDirectoryDTO>;
+    /** 授業のディレクトリ配下の教材一覧を取得する */
+    getClassContent(classId: string, directoryId: string, viewType?: string): Promise<ManaboClassContentDTO>;
+    /**
+     * 出席受付モーダル（出欠カード）のフォームを取得する。
+     * 返り値の `requiresCode` が `true` なら出席コード（パスワード）が必要で、
+     * {@link submitEntry} の `code` に教員指示のコードを渡す。`false`（パスワードなし授業）
+     * なら `code` を省略してそのまま送信できる。
+     */
+    getEntryForm(classId: string): Promise<ManaboEntryFormDTO>;
+    /**
+     * 出席登録を送信する（{@link getEntryForm} で取得した entryId / uniqid を渡す）。
+     * 出席コード（パスワード）必須の授業では `code` に教員指示のコードを渡す。
+     * パスワードなし授業では `code` を省略する。
+     */
+    submitEntry(params: {
+        classId: string;
+        directoryId: string;
+        entryId: string;
+        uniqid: string;
+        code?: string;
+    }): Promise<ManaboEntryResponseDTO>;
+    /**
+     * 受信メール一覧を取得する。
+     * リクエスト形は glexa JS の `glexa.loadMailReceives(p, q, o, unread, start, end)` で確認済み。
+     * @param options.page ページ番号（1 始まり） / q 検索語 / order 並び順 / unreadOnly 未読のみ / startDate・endDate 期間（YYYY-MM-DD）
+     */
+    getReceivedMail(options?: {
+        page?: number | string;
+        q?: string;
+        order?: string;
+        unreadOnly?: boolean;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ManaboReceivedMailDTO>;
+    /**
+     * 送信メール一覧を取得する。
+     * リクエスト形は glexa JS の `glexa.loadMailSends(p, q, o, start, end)` で確認済み。
+     */
+    getSentMail(options?: {
+        page?: number | string;
+        q?: string;
+        order?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ManaboSentMailDTO>;
+    /** メール本文（閲覧モーダル）を取得する */
+    getMailView(mailId: string): Promise<ManaboMailViewDTO>;
+    /**
+     * メール作成モーダルで宛先候補メンバーを検索する（`q` は氏名/学籍番号などの検索語）。
+     * リクエスト形は HAR 内の inline JS（`glexa.ajax({ action: 'glexa_modal_mail_ajax_member_list', params: { q } })`）で確認済み。
+     */
+    searchMailMembers(q: string): Promise<ManaboMailMemberDTO>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/manabo/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/manabo/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3J,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3H,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEhD,OAAO,CAAC,SAAS;IASjB,gDAAgD;IAChD,OAAO,CAAC,UAAU;IAQlB,eAAe;IACT,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIjD,qBAAqB;IACf,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQhE,mBAAmB;IACb,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIxE,2BAA2B;IACrB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQlE,4BAA4B;IACtB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQ1E,4BAA4B;IACtB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAa9G;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQhE;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAapJ;;;;OAIG;IACG,eAAe,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgBvL;;;OAGG;IACG,WAAW,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAezJ,yBAAyB;IACnB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ7D;;;OAGG;IACG,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CASnE"}