chukyo-sdk 0.1.0

package/dist/cjs/common/dom.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matches = exports.getChildrenElements = exports.filterElements = exports.isElement = exports.previousSiblingElement = exports.nextSiblingElement = exports.closest = exports.elementHasClass = exports.getInnerHtml = exports.getTextContent = exports.getAttribute = exports.queryOne = exports.queryAll = exports.loadDocument = void 0;
+/**
+ * HTML パース用の薄い DOM ヘルパ層。
+ *
+ * `htmlparser2`（`parseDocument`）でパースし、`css-select` でセレクタ検索、
+ * `domutils` でノード走査する。各 parser はこのヘルパ経由で DOM を扱う。
+ */
+const htmlparser2_1 = require("htmlparser2");
+const css_select_1 = require("css-select");
+const domutils_1 = require("domutils");
+const toArray = (root) => {
+    if (!root) {
+        return [];
+    }
+    if (Array.isArray(root)) {
+        return root;
+    }
+    if ("children" in root && Array.isArray(root.children)) {
+        return root.children;
+    }
+    return [root];
+};
+/** HTML 文字列を Document に変換する */
+const loadDocument = (html) => (0, htmlparser2_1.parseDocument)(html);
+exports.loadDocument = loadDocument;
+/** セレクタに一致する全 Element を返す */
+const queryAll = (selector, root) => (0, css_select_1.selectAll)(selector, toArray(root));
+exports.queryAll = queryAll;
+/** セレクタに一致する最初の Element を返す（無ければ null） */
+const queryOne = (selector, root) => (0, css_select_1.selectOne)(selector, toArray(root));
+exports.queryOne = queryOne;
+/** 属性値を取得する（無ければ null） */
+const getAttribute = (element, name) => {
+    if (!element) {
+        return null;
+    }
+    const value = (0, domutils_1.getAttributeValue)(element, name);
+    return typeof value === "string" ? value : null;
+};
+exports.getAttribute = getAttribute;
+/** ノード配下のテキストを連結して返す */
+const getTextContent = (node) => {
+    if (!node) {
+        return "";
+    }
+    return (0, domutils_1.textContent)(node);
+};
+exports.getTextContent = getTextContent;
+const decodeNumericEntities = (value) => value
+    .replace(/&#x([0-9a-fA-F]+);/g, (match, hex) => {
+    const codePoint = Number.parseInt(hex, 16);
+    return Number.isNaN(codePoint) ? match : String.fromCodePoint(codePoint);
+})
+    .replace(/&#([0-9]+);/g, (match, dec) => {
+    const codePoint = Number.parseInt(dec, 10);
+    return Number.isNaN(codePoint) ? match : String.fromCodePoint(codePoint);
+});
+/**
+ * 要素の innerHTML を返す。数値文字参照の復号・改行正規化・` ` 復元・
+ * 値のない `alt` の補完を行い、後段のパースを安定させる。
+ */
+const getInnerHtml = (element) => {
+    if (!element) {
+        return "";
+    }
+    const inner = (0, domutils_1.getInnerHTML)(element);
+    const decoded = decodeNumericEntities(inner);
+    const normalised = decoded.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const withNbsp = normalised.replace(/\u00a0/g, " ");
+    return withNbsp.replace(/\salt(?!\s*=)(?=[\s/>])/g, ' alt=""');
+};
+exports.getInnerHtml = getInnerHtml;
+/** 要素が指定クラスを持つか */
+const elementHasClass = (element, className) => {
+    if (!element) {
+        return false;
+    }
+    const classAttr = (0, exports.getAttribute)(element, "class");
+    if (!classAttr) {
+        return false;
+    }
+    return classAttr.split(/\s+/).includes(className);
+};
+exports.elementHasClass = elementHasClass;
+/** 自身から祖先方向へ辿り、セレクタに最初に一致する要素を返す */
+const closest = (element, selector) => {
+    let current = element;
+    while (current) {
+        if ((0, css_select_1.is)(current, selector)) {
+            return current;
+        }
+        const parent = (0, domutils_1.getParent)(current);
+        current = parent && (0, domutils_1.isTag)(parent) ? parent : null;
+    }
+    return null;
+};
+exports.closest = closest;
+/** 次の兄弟要素を返す */
+const nextSiblingElement = (element) => {
+    if (!element) {
+        return null;
+    }
+    return (0, domutils_1.nextElementSibling)(element) ?? null;
+};
+exports.nextSiblingElement = nextSiblingElement;
+/** 前の兄弟要素を返す */
+const previousSiblingElement = (element) => {
+    if (!element) {
+        return null;
+    }
+    return (0, domutils_1.prevElementSibling)(element) ?? null;
+};
+exports.previousSiblingElement = previousSiblingElement;
+/** ノードが Element（タグ）か */
+const isElement = (node) => !!node && (0, domutils_1.isTag)(node);
+exports.isElement = isElement;
+/** ノード配列から Element だけを抽出する */
+const filterElements = (nodes) => nodes.filter((node) => (0, domutils_1.isTag)(node));
+exports.filterElements = filterElements;
+/** 子ノードのうち Element だけを返す */
+const getChildrenElements = (element) => {
+    if (!element) {
+        return [];
+    }
+    return (0, exports.filterElements)(element.children ?? []);
+};
+exports.getChildrenElements = getChildrenElements;
+/** 要素がセレクタに一致するか */
+const matches = (element, selector) => {
+    if (!element) {
+        return false;
+    }
+    return (0, css_select_1.is)(element, selector);
+};
+exports.matches = matches;

package/dist/cjs/common/utils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formEncodeArray = exports.formEncode = exports.extractFirstQuotedValue = exports.normalizeWhitespace = void 0;
+/** 連続する空白を1つに畳み、前後を trim する */
+const normalizeWhitespace = (value) => value.replace(/\s+/g, " ").trim();
+exports.normalizeWhitespace = normalizeWhitespace;
+/** 文字列中の最初のシングルクォート内の値を返す（onclick 引数の抽出などに使う） */
+const extractFirstQuotedValue = (raw) => {
+    if (!raw) {
+        return null;
+    }
+    const match = raw.match(/'([^']+)'/);
+    return match ? (match[1] ?? null) : null;
+};
+exports.extractFirstQuotedValue = extractFirstQuotedValue;
+/**
+ * `{ key: value }` を form-urlencoded ボディに変換する。
+ * shib のフォーム POST（loginuserpass 等）のボディ組み立てに使う。
+ */
+const formEncode = (params) => Object.entries(params)
+    .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+    .join("&");
+exports.formEncode = formEncode;
+/**
+ * `[key, value]` ペア配列を form-urlencoded ボディに変換する（キー重複対応）。
+ * `Fido2DeviceAdd` のように同名キー（`procchk` を 2 回）を送る必要がある場合に使う。
+ */
+const formEncodeArray = (params) => params.map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join("&");
+exports.formEncodeArray = formEncodeArray;

package/dist/cjs/constants.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * ポータルのデータ系エンドポイント URL と運用値。
+ *
+ * 運用値（リトライ回数・タイムアウト）は旧 UMEBO の実運用で得た値。根拠なく変えない。
+ * ※ Shibboleth 認証 URL やレート制限・セッション失効時間は SDK には持たない
+ *   （認証・レート制限は利用側 = umebo の責務）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICES = exports.SHIB_URLS = exports.MANABO_URLS = exports.ALBO_DEFAULT_CALENDAR_SOURCE_UUID = exports.ALBO_URLS = exports.CUBICS_URLS = exports.CUBICS_RETRY_DELAY_RANDOM_MS = exports.CUBICS_RETRY_DELAY_MS = exports.CUBICS_RETRY_COUNT = exports.HTTP_TIMEOUT_MS = void 0;
+/** HTTP タイムアウト（ms） */
+exports.HTTP_TIMEOUT_MS = 10_000;
+/** CUBICS セッション不安定対策のリトライ回数 */
+exports.CUBICS_RETRY_COUNT = 3;
+/** CUBICS リトライの固定遅延（ms） */
+exports.CUBICS_RETRY_DELAY_MS = 200;
+/** CUBICS リトライのランダム加算遅延の上限（ms） */
+exports.CUBICS_RETRY_DELAY_RANDOM_MS = 300;
+// ============================================
+// CUBICS（教務システム）— 画面遷移型 HTML
+// ============================================
+exports.CUBICS_URLS = {
+    /** ベース URL */
+    base: "https://cubics-as.chukyo-u.ac.jp",
+};
+// ============================================
+// Albo（ポータルサイト）— 3システムで唯一の JSON REST API
+// ============================================
+exports.ALBO_URLS = {
+    /** ベース URL */
+    base: "https://albo.chukyo-u.ac.jp",
+    /** SAML ログイン起点 */
+    login: "https://albo.chukyo-u.ac.jp/api/saml/login",
+    /** 認証完了確認（ここへの到達でログイン成立） */
+    dashboard: "https://albo.chukyo-u.ac.jp/dashboard",
+};
+/**
+ * 学年暦（学部）カレンダーソース UUID。`GET /api/calendar-source/` が返す一覧の1件で、
+ * 年度更新等で値が変わり得る。`AlboClient#getCalendar` はこれをデフォルト値として使うが、
+ * 呼び出し側は `getCalendar({ calendarSourceUuid: ... })` で任意のソース（学部/大学院など）
+ * に差し替えられる。差し替え先の UUID は `getCalendarSource()` の結果から取得できる。
+ */
+exports.ALBO_DEFAULT_CALENDAR_SOURCE_UUID = "ac304d66-b0a8-11f0-afed-06347f3ce845";
+// ============================================
+// MaNaBo（学習管理システム）— API なし、glexa_ajax_* POST で HTML 断片
+// ============================================
+exports.MANABO_URLS = {
+    /** ベース URL */
+    base: "https://manabo.cnc.chukyo-u.ac.jp",
+    /** Shibboleth 認証 URL */
+    auth: "https://manabo.cnc.chukyo-u.ac.jp/auth/shibboleth/",
+};
+// ============================================
+// Shibboleth（共通認証 / CloudLink IdP + ACE User ポータル）
+// ============================================
+/**
+ * Shibboleth 認証系エンドポイント。
+ *
+ * ※ この SDK は認証フローを「実行」しない。`src/shib` のビルダ/パーサが、
+ *   各ステップのリクエスト記述子の組み立てと、レスポンスの構造化に使う。
+ *   HTTP 実行・Cookie 管理・リダイレクト追従・パスキー暗号処理は呼び出し側の責務。
+ * 値は umebo の実運用 URL（acl/constants.ts）に一致。
+ */
+exports.SHIB_URLS = {
+    /** Shibboleth オリジン（フォーム POST の Origin ヘッダに使う） */
+    origin: "https://shib.chukyo-u.ac.jp",
+    /** WebAuthn RP ID */
+    rpId: "shib.chukyo-u.ac.jp",
+    /** ACE User SP ログイン起点 */
+    clspLogin: "https://shib.chukyo-u.ac.jp/clsp/login",
+    /** CLSP SAML ログイン起点（パスキー登録フローの起点） */
+    clspSamlLogin: "https://shib.chukyo-u.ac.jp/clsp/saml/login",
+    /** 認証方式チェック（Password / OTP / Passkey の可否） */
+    checktype: "https://shib.chukyo-u.ac.jp/cloudlink/module.php/cloudlink/checktype.php",
+    /** ログインフォーム POST（authtype=0 PW / 2 OTP / 3 Passkey） */
+    cloudlinkLoginForm: "https://shib.chukyo-u.ac.jp/cloudlink/module.php/cloudlink/loginuserpass.php",
+    /** ログインフロー用 WebAuthn API（start/finish-authentication） */
+    webauthn: "https://shib.chukyo-u.ac.jp/cloudlink/module.php/cloudlink/webauthn.php",
+    /** ACE User メニュー */
+    userMenu: "https://shib.chukyo-u.ac.jp/User/Menu",
+    /** ACE User メニュー選択 */
+    userMenuSelect: "https://shib.chukyo-u.ac.jp/User/MenuSelect",
+    /** ACE User タイムゾーン・言語設定完了 */
+    userTimeZoneLangEnd: "https://shib.chukyo-u.ac.jp/User/TimeZoneLangEnd",
+    /** ACE User FIDO2 デバイス追加ページ */
+    userFido2DeviceAdd: "https://shib.chukyo-u.ac.jp/User/Fido2DeviceAdd",
+    /** ACE User FIDO2 デバイス追加完了 */
+    userFido2DeviceAddEnd: "https://shib.chukyo-u.ac.jp/User/Fido2DeviceAddEnd",
+    /** ACE User FIDO2 デバイス一覧 */
+    userFido2DeviceList: "https://shib.chukyo-u.ac.jp/User/Fido2DeviceList",
+    /** ACE User FIDO2 デバイス削除完了 */
+    userFido2DeviceDelEnd: "https://shib.chukyo-u.ac.jp/User/Fido2DeviceDelEnd",
+    /** ACE User 登録フロー用 WebAuthn API（start/finish-registration） */
+    userWebauthn: "https://shib.chukyo-u.ac.jp/User/webauthn",
+    /** OTP 認証方式選択チェック */
+    userSelectAuthTypeCheck: "https://shib.chukyo-u.ac.jp/User/SelectAuthTypeCheck",
+    /** OTP メールアドレス入力チェック */
+    userInputMailAddresCheck: "https://shib.chukyo-u.ac.jp/User/InputMailAddresCheck",
+    /** OTP 仮パスワード入力チェック */
+    userInputTemporaryOtpCheck: "https://shib.chukyo-u.ac.jp/User/InputTemporaryOtpCheck",
+    /** OTP アプリインストール導線表示チェック */
+    userDisplayInstallAppliLinkCheck: "https://shib.chukyo-u.ac.jp/User/DisplayInstallAppliLinkCheck",
+    /** OTP（PC 用）入力チェック */
+    userInputOtpForPCCheck: "https://shib.chukyo-u.ac.jp/User/InputOtpForPCCheck",
+    /** OTP 仮パスワード入力 */
+    userInputTemporaryOtp: "https://shib.chukyo-u.ac.jp/User/InputTemporaryOtp",
+    /** ACE User ログアウト（SLO 連鎖の起点） */
+    userLogout: "https://shib.chukyo-u.ac.jp/User/Logout",
+};
+/** サービス記述子（enterUrl / goalUrl）。SessionProvider に渡す。 */
+exports.SERVICES = {
+    cubics: {
+        key: "cubics",
+        enterUrl: `${exports.CUBICS_URLS.base}/unias/UnSSOLoginControl2`,
+        goalUrl: `${exports.CUBICS_URLS.base}/unias/UnSSOLoginControl2`,
+    },
+    albo: {
+        key: "albo",
+        enterUrl: exports.ALBO_URLS.login,
+        goalUrl: exports.ALBO_URLS.dashboard,
+    },
+    manabo: {
+        key: "manabo",
+        enterUrl: exports.MANABO_URLS.auth,
+        goalUrl: exports.MANABO_URLS.auth,
+    },
+};

package/dist/cjs/core/request.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrap = exports.portalRequestText = exports.portalRequest = void 0;
+const errors_1 = require("../errors");
+/** Cookie を（あれば）注入して1回リクエストする。 */
+const portalRequest = async (ctx, service, init) => {
+    const headers = {
+        "Accept-Language": "ja",
+        ...init.headers,
+    };
+    if (ctx.session) {
+        headers["cookie"] = await ctx.session.getCookieHeader(service);
+    }
+    return ctx.transport.request({
+        method: init.method,
+        url: init.url,
+        headers,
+        ...(init.body != null ? { body: init.body } : {}),
+        ...(init.signal ? { signal: init.signal } : {}),
+    });
+};
+exports.portalRequest = portalRequest;
+/** Cookie を注入してボディ文字列だけを返す。 */
+const portalRequestText = async (ctx, service, init) => {
+    const res = await (0, exports.portalRequest)(ctx, service, init);
+    return res.body;
+};
+exports.portalRequestText = portalRequestText;
+/**
+ * parser の {@link ZodSafeParseResult} を DTO に unwrap する。失敗時は {@link ParseError}。
+ * 各クライアントメソッドの戻り値を「生 DTO」に統一するための共通処理。
+ */
+const unwrap = (result) => {
+    if (!result.success) {
+        throw new errors_1.ParseError({ cause: result.error });
+    }
+    return result.data;
+};
+exports.unwrap = unwrap;

package/dist/cjs/cubics/client.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CubicsClient = void 0;
+/**
+ * CUBICS クライアント。画面遷移型でセッションが不安定なため、無効を検知したら
+ * セッションを invalidate してランダム遅延を挟み最大 {@link CUBICS_RETRY_COUNT} 回リトライする。
+ */
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+const request_1 = require("../core/request");
+const cubics_1 = require("./parser/cubics");
+const INVALID_TITLES = ["<title>Missing cookie</title>", "<title>クッキーが見つかりません</title>"];
+class CubicsClient {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /** セッション無効時は base 外へのリダイレクト、または "Missing cookie" タイトルが返る */
+    isSessionValid(res) {
+        if (!res.url.startsWith(constants_1.CUBICS_URLS.base)) {
+            return false;
+        }
+        return !INVALID_TITLES.some((title) => res.body.includes(title));
+    }
+    async waitForRetryDelay() {
+        const delay = constants_1.CUBICS_RETRY_DELAY_MS + Math.floor(Math.random() * constants_1.CUBICS_RETRY_DELAY_RANDOM_MS);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+    async fetchText(path) {
+        for (let attempt = 0; attempt <= constants_1.CUBICS_RETRY_COUNT; attempt++) {
+            const res = await (0, request_1.portalRequest)(this.ctx, constants_1.SERVICES.cubics, {
+                method: "GET",
+                url: `${constants_1.CUBICS_URLS.base}${path}`,
+            });
+            if (this.isSessionValid(res)) {
+                return res.body;
+            }
+            this.ctx.session?.invalidate(constants_1.SERVICES.cubics.key);
+            await this.waitForRetryDelay();
+        }
+        throw new errors_1.ExpiredSessionError();
+    }
+    /** 週間時間割を取得する */
+    async getTimetable() {
+        const html = await this.fetchText("/unias/UnSSOLoginControl2?REQ_ACTION_DO=/ARF010.do&REQ_PRFR_MNU_ID=MNUIDSTD0103");
+        return (0, request_1.unwrap)((0, cubics_1.parseCubicsAsTimetable)(html));
+    }
+}
+exports.CubicsClient = CubicsClient;

package/dist/cjs/cubics/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CubicsClient = exports.parseCubicsAsTimetable = void 0;
+var cubics_1 = require("./parser/cubics");
+Object.defineProperty(exports, "parseCubicsAsTimetable", { enumerable: true, get: function () { return cubics_1.parseCubicsAsTimetable; } });
+__exportStar(require("./types/cubics"), exports);
+var client_1 = require("./client");
+Object.defineProperty(exports, "CubicsClient", { enumerable: true, get: function () { return client_1.CubicsClient; } });

package/dist/cjs/cubics/parser/cubics.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCubicsAsTimetable = void 0;
+const dom_1 = require("../../common/dom");
+const utils_1 = require("../../common/utils");
+const cubics_1 = require("../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((0, dom_1.getAttribute)((0, dom_1.queryOne)(selector, root), "value"));
+const parseCubicsAsTimetable = (html) => {
+    const document = (0, dom_1.loadDocument)(html);
+    // --- 学生情報（table.output） ---
+    const studentTable = (0, dom_1.queryOne)("table.output", document);
+    const studentRows = studentTable ? (0, dom_1.queryAll)("tr", studentTable) : [];
+    const row1Cells = studentRows[0] ? (0, dom_1.queryAll)("td", studentRows[0]) : [];
+    const row2Cells = studentRows[1] ? (0, dom_1.queryAll)("td", studentRows[1]) : [];
+    const row3Cells = studentRows[2] ? (0, dom_1.queryAll)("td", studentRows[2]) : [];
+    const row4Cells = studentRows[3] ? (0, dom_1.queryAll)("td", studentRows[3]) : [];
+    const getCellText = (cells, index) => (0, utils_1.normalizeWhitespace)((0, dom_1.getTextContent)(cells[index] ?? null));
+    // 氏名セルは "日本語氏名<BR />(ALPHABET NAME)" 形式。<BR> で分割し、後半の括弧を除去する。
+    const nameCellHtml = (0, dom_1.getInnerHtml)(row1Cells[1] ?? null);
+    const nameParts = nameCellHtml.split(BR_PATTERN);
+    const name = (0, utils_1.normalizeWhitespace)((0, dom_1.getTextContent)((0, dom_1.loadDocument)(nameParts[0] ?? "")));
+    const alphabetRaw = (0, utils_1.normalizeWhitespace)((0, dom_1.getTextContent)((0, dom_1.loadDocument)(nameParts[1] ?? "")));
+    const alphabetInner = alphabetRaw.replace(/^\(/, "").replace(/\)$/, "");
+    const nameAlphabet = emptyOrNull((0, utils_1.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 = (0, dom_1.queryOne)("input[name='lblSpcfProd']", document);
+    const periodRange = (0, utils_1.normalizeWhitespace)((0, dom_1.getAttribute)(periodInput, "value") ?? "");
+    // --- 時間割表（table.output_curriculum） ---
+    const curriculumTable = (0, dom_1.queryOne)("table.output_curriculum", document);
+    const headerRow = curriculumTable ? (0, dom_1.queryOne)("tr", curriculumTable) : null;
+    const headerCells = headerRow ? (0, dom_1.queryAll)("th", headerRow).slice(1) : [];
+    const days = headerCells.map((element) => {
+        // input[name$=".lblLsnDt"] の value は "月<BR/>06/16"（属性値なのでエンティティは復号済み）。
+        const raw = (0, dom_1.getAttribute)((0, dom_1.queryOne)('input[name$=".lblLsnDt"]', element), "value");
+        const parts = (raw ?? "").split(BR_PATTERN).map((part) => (0, utils_1.normalizeWhitespace)(part));
+        return {
+            weekday: parts[0] ?? "",
+            date: parts[1] ?? "",
+        };
+    });
+    const periodRows = curriculumTable ? (0, dom_1.queryAll)("tr", curriculumTable).slice(1) : [];
+    const periods = periodRows.map((row) => {
+        const periodLabel = (0, utils_1.normalizeWhitespace)((0, dom_1.getTextContent)((0, dom_1.queryOne)("th", row)));
+        const cells = (0, dom_1.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 = (0, dom_1.getAttribute)((0, dom_1.queryOne)('input[name$=".hdnClrNm"]', cell), "value");
+            const classroomNormalized = emptyOrNull((0, utils_1.normalizeWhitespace)((classroomFull ?? "").replace(BR_PATTERN, " ")));
+            const classroom = classroomNormalized ?? getInputValue('input[name$=".lblClrNm"]', cell);
+            // 詳細URL: execPopupWindowOpen(...) を含む onclick の最初のシングルクォート引数。
+            const detailAnchor = (0, dom_1.queryAll)("a", cell).find((anchor) => ((0, dom_1.getAttribute)(anchor, "onclick") ?? "").includes("execPopupWindowOpen"));
+            const detailUrl = (0, utils_1.extractFirstQuotedValue)(detailAnchor ? (0, dom_1.getAttribute)(detailAnchor, "onclick") : null);
+            // ステータスアイコン: img の src で判定。
+            const iconSources = (0, dom_1.queryAll)("img", cell).map((img) => (0, dom_1.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 cubics_1.CubicsAsTimetableSchema.safeParse({ student, periodRange, days, periods });
+};
+exports.parseCubicsAsTimetable = parseCubicsAsTimetable;

package/dist/cjs/cubics/types/cubics.js

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

package/dist/cjs/errors.js

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