chukyo-sdk 0.1.0

package/dist/esm/albo/types/alboUniversalForm.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { alboEnvelope, paginationShape } from "./alboCommon";
+// ---------------------------------------------------------------------------
+// 汎用申請（universal-form / 各種手続き）系。
+//   - GET /api/universal-form/{page}           … 申請フォーム一覧
+//   - GET /api/universal-form-category/{page}  … 申請カテゴリ一覧
+// ---------------------------------------------------------------------------
+/** 汎用申請のカテゴリ */
+export const AlboUniversalFormCategorySchema = z.object({
+    /** カテゴリ UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    uuid: z.string().meta({ description: "カテゴリ UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** カテゴリ名（例: "教務"） @example "教務" */
+    name: z.string().meta({ description: "カテゴリ名", example: "教務" }),
+    /** カテゴリ名（英語。無ければ null） @example null */
+    name_en: z.string().nullable().meta({ description: "カテゴリ名（英語）", example: null }),
+    /** 説明（無ければ null） @example null */
+    description: z.string().nullable().meta({ description: "説明", example: null }),
+    /** 説明（英語。無ければ null） @example null */
+    description_en: z.string().nullable().meta({ description: "説明（英語）", example: null }),
+    /** 強制申請に設定できるか（0/1 の数値フラグ） @example 0 */
+    can_set_forced: z.number().meta({ description: "強制申請に設定できるか（0/1）", example: 0 }),
+    /** 表示順 @example 0 */
+    order: z.number().meta({ description: "表示順", example: 0 }),
+    /** 作成者 @example "system" */
+    created_by: z.string().meta({ description: "作成者", example: "system" }),
+    /** 更新者（無ければ null） @example null */
+    updated_by: z.string().nullable().meta({ description: "更新者", example: null }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+});
+/** 汎用申請カテゴリ一覧取得 API のレスポンス全体 */
+export const AlboUniversalFormCategoryListSchema = alboEnvelope(z.object({
+    ...paginationShape,
+    /** カテゴリ配列 */
+    items: z.array(AlboUniversalFormCategorySchema).meta({ description: "カテゴリ配列" }),
+}));
+/**
+ * 汎用申請一覧取得 API のレスポンス全体。
+ * 観測できたのは対象フォームが 0 件（`items: []`）のケースのみ。
+ * 個々のフォーム項目の構造は未確認のため、要素は無変換で保持する。
+ */
+export const AlboUniversalFormSchema = alboEnvelope(z.object({
+    ...paginationShape,
+    /** 申請フォームの配列 @example [] */
+    items: z.array(z.unknown()).meta({ description: "申請フォームの配列", example: [] }),
+}));

package/dist/esm/common/dom.d.ts

@@ -0,0 +1,35 @@
+import type { AnyNode, Document, Element } from "domhandler";
+type Root = Document | Element | AnyNode[] | null | undefined;
+/** HTML 文字列を Document に変換する */
+export declare const loadDocument: (html: string) => Document;
+/** セレクタに一致する全 Element を返す */
+export declare const queryAll: (selector: string, root: Root) => Element[];
+/** セレクタに一致する最初の Element を返す（無ければ null） */
+export declare const queryOne: (selector: string, root: Root) => Element | null;
+/** 属性値を取得する（無ければ null） */
+export declare const getAttribute: (element: Element | null | undefined, name: string) => string | null;
+/** ノード配下のテキストを連結して返す */
+export declare const getTextContent: (node: AnyNode | null | undefined) => string;
+/**
+ * 要素の innerHTML を返す。数値文字参照の復号・改行正規化・` ` 復元・
+ * 値のない `alt` の補完を行い、後段のパースを安定させる。
+ */
+export declare const getInnerHtml: (element: Element | null | undefined) => string;
+/** 要素が指定クラスを持つか */
+export declare const elementHasClass: (element: Element | null | undefined, className: string) => boolean;
+/** 自身から祖先方向へ辿り、セレクタに最初に一致する要素を返す */
+export declare const closest: (element: Element | null | undefined, selector: string) => Element | null;
+/** 次の兄弟要素を返す */
+export declare const nextSiblingElement: (element: Element | null | undefined) => Element | null;
+/** 前の兄弟要素を返す */
+export declare const previousSiblingElement: (element: Element | null | undefined) => Element | null;
+/** ノードが Element（タグ）か */
+export declare const isElement: (node: AnyNode | null | undefined) => node is Element;
+/** ノード配列から Element だけを抽出する */
+export declare const filterElements: (nodes: AnyNode[]) => Element[];
+/** 子ノードのうち Element だけを返す */
+export declare const getChildrenElements: (element: Element | null | undefined) => Element[];
+/** 要素がセレクタに一致するか */
+export declare const matches: (element: Element | null | undefined, selector: string) => boolean;
+export { type Element } from "domhandler";
+//# sourceMappingURL=dom.d.ts.map

package/dist/esm/common/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/common/dom.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAY7D,KAAK,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAe9D,+BAA+B;AAC/B,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,QAA+B,CAAC;AAE5E,6BAA6B;AAC7B,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,MAAM,IAAI,KAAG,OAAO,EAAwC,CAAC;AAExG,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,MAAM,IAAI,KAAG,OAAO,GAAG,IAA0C,CAAC;AAE7G,0BAA0B;AAC1B,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,IAMzF,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,MAKjE,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,MASlE,CAAC;AAEF,mBAAmB;AACnB,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,MAAM,KAAG,OASxF,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,OAAO,GAAG,IAUzF,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,OAAO,GAAG,IAKlF,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,OAAO,GAAG,IAKtF,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,IAAI,IAAI,OAAgC,CAAC;AAEtG,8BAA8B;AAC9B,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,EAAE,KAAG,OAAO,EAA0D,CAAC;AAEpH,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,KAAG,OAAO,EAKhF,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,OAK/E,CAAC;AAEF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/common/dom.js

@@ -0,0 +1,120 @@
+/**
+ * HTML パース用の薄い DOM ヘルパ層。
+ *
+ * `htmlparser2`（`parseDocument`）でパースし、`css-select` でセレクタ検索、
+ * `domutils` でノード走査する。各 parser はこのヘルパ経由で DOM を扱う。
+ */
+import { parseDocument } from "htmlparser2";
+import { is as matchesSelector, selectAll, selectOne } from "css-select";
+import { getAttributeValue, getInnerHTML, getParent, isTag, nextElementSibling, prevElementSibling, textContent, } from "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 に変換する */
+export const loadDocument = (html) => parseDocument(html);
+/** セレクタに一致する全 Element を返す */
+export const queryAll = (selector, root) => selectAll(selector, toArray(root));
+/** セレクタに一致する最初の Element を返す（無ければ null） */
+export const queryOne = (selector, root) => selectOne(selector, toArray(root));
+/** 属性値を取得する（無ければ null） */
+export const getAttribute = (element, name) => {
+    if (!element) {
+        return null;
+    }
+    const value = getAttributeValue(element, name);
+    return typeof value === "string" ? value : null;
+};
+/** ノード配下のテキストを連結して返す */
+export const getTextContent = (node) => {
+    if (!node) {
+        return "";
+    }
+    return textContent(node);
+};
+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` の補完を行い、後段のパースを安定させる。
+ */
+export const getInnerHtml = (element) => {
+    if (!element) {
+        return "";
+    }
+    const inner = 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=""');
+};
+/** 要素が指定クラスを持つか */
+export const elementHasClass = (element, className) => {
+    if (!element) {
+        return false;
+    }
+    const classAttr = getAttribute(element, "class");
+    if (!classAttr) {
+        return false;
+    }
+    return classAttr.split(/\s+/).includes(className);
+};
+/** 自身から祖先方向へ辿り、セレクタに最初に一致する要素を返す */
+export const closest = (element, selector) => {
+    let current = element;
+    while (current) {
+        if (matchesSelector(current, selector)) {
+            return current;
+        }
+        const parent = getParent(current);
+        current = parent && isTag(parent) ? parent : null;
+    }
+    return null;
+};
+/** 次の兄弟要素を返す */
+export const nextSiblingElement = (element) => {
+    if (!element) {
+        return null;
+    }
+    return nextElementSibling(element) ?? null;
+};
+/** 前の兄弟要素を返す */
+export const previousSiblingElement = (element) => {
+    if (!element) {
+        return null;
+    }
+    return prevElementSibling(element) ?? null;
+};
+/** ノードが Element（タグ）か */
+export const isElement = (node) => !!node && isTag(node);
+/** ノード配列から Element だけを抽出する */
+export const filterElements = (nodes) => nodes.filter((node) => isTag(node));
+/** 子ノードのうち Element だけを返す */
+export const getChildrenElements = (element) => {
+    if (!element) {
+        return [];
+    }
+    return filterElements(element.children ?? []);
+};
+/** 要素がセレクタに一致するか */
+export const matches = (element, selector) => {
+    if (!element) {
+        return false;
+    }
+    return matchesSelector(element, selector);
+};

package/dist/esm/common/utils.d.ts

@@ -0,0 +1,15 @@
+/** 連続する空白を1つに畳み、前後を trim する */
+export declare const normalizeWhitespace: (value: string) => string;
+/** 文字列中の最初のシングルクォート内の値を返す（onclick 引数の抽出などに使う） */
+export declare const extractFirstQuotedValue: (raw: string | undefined | null) => string | null;
+/**
+ * `{ key: value }` を form-urlencoded ボディに変換する。
+ * shib のフォーム POST（loginuserpass 等）のボディ組み立てに使う。
+ */
+export declare const formEncode: (params: Record<string, string>) => string;
+/**
+ * `[key, value]` ペア配列を form-urlencoded ボディに変換する（キー重複対応）。
+ * `Fido2DeviceAdd` のように同名キー（`procchk` を 2 回）を送る必要がある場合に使う。
+ */
+export declare const formEncodeArray: (params: ReadonlyArray<readonly [string, string]>) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/common/utils.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,MAA2C,CAAC;AAEhG,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,MAAM,GAAG,IAMjF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAG1C,CAAC;AAEnB;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,MACkB,CAAC"}

package/dist/esm/common/utils.js

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

package/dist/esm/constants.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sBAAsB;AACtB,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,2BAA2B;AAC3B,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,kCAAkC;AAClC,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAKhD,eAAO,MAAM,WAAW;IACpB,cAAc;;CAER,CAAC;AAKX,eAAO,MAAM,SAAS;IAClB,cAAc;;IAEd,kBAAkB;;IAElB,4BAA4B;;CAEtB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,yCAAyC,CAAC;AAKxF,eAAO,MAAM,WAAW;IACpB,cAAc;;IAEd,wBAAwB;;CAElB,CAAC;AAKX;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;IAClB,iDAAiD;;IAEjD,qBAAqB;;IAErB,yBAAyB;;IAEzB,qCAAqC;;IAErC,6CAA6C;;IAE7C,uDAAuD;;IAEvD,yDAAyD;;IAEzD,oBAAoB;;IAEpB,sBAAsB;;IAEtB,6BAA6B;;IAE7B,+BAA+B;;IAE/B,8BAA8B;;IAE9B,4BAA4B;;IAE5B,8BAA8B;;IAE9B,8DAA8D;;IAE9D,qBAAqB;;IAErB,wBAAwB;;IAExB,uBAAuB;;IAEvB,4BAA4B;;IAE5B,sBAAsB;;IAEtB,mBAAmB;;IAEnB,gCAAgC;;CAE1B,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;CAgBX,CAAC"}

package/dist/esm/constants.js

@@ -0,0 +1,124 @@
+/**
+ * ポータルのデータ系エンドポイント URL と運用値。
+ *
+ * 運用値（リトライ回数・タイムアウト）は旧 UMEBO の実運用で得た値。根拠なく変えない。
+ * ※ Shibboleth 認証 URL やレート制限・セッション失効時間は SDK には持たない
+ *   （認証・レート制限は利用側 = umebo の責務）。
+ */
+/** HTTP タイムアウト（ms） */
+export const HTTP_TIMEOUT_MS = 10_000;
+/** CUBICS セッション不安定対策のリトライ回数 */
+export const CUBICS_RETRY_COUNT = 3;
+/** CUBICS リトライの固定遅延（ms） */
+export const CUBICS_RETRY_DELAY_MS = 200;
+/** CUBICS リトライのランダム加算遅延の上限（ms） */
+export const CUBICS_RETRY_DELAY_RANDOM_MS = 300;
+// ============================================
+// CUBICS（教務システム）— 画面遷移型 HTML
+// ============================================
+export const CUBICS_URLS = {
+    /** ベース URL */
+    base: "https://cubics-as.chukyo-u.ac.jp",
+};
+// ============================================
+// Albo（ポータルサイト）— 3システムで唯一の JSON REST API
+// ============================================
+export const 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()` の結果から取得できる。
+ */
+export const ALBO_DEFAULT_CALENDAR_SOURCE_UUID = "ac304d66-b0a8-11f0-afed-06347f3ce845";
+// ============================================
+// MaNaBo（学習管理システム）— API なし、glexa_ajax_* POST で HTML 断片
+// ============================================
+export const 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）に一致。
+ */
+export const 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 に渡す。 */
+export const SERVICES = {
+    cubics: {
+        key: "cubics",
+        enterUrl: `${CUBICS_URLS.base}/unias/UnSSOLoginControl2`,
+        goalUrl: `${CUBICS_URLS.base}/unias/UnSSOLoginControl2`,
+    },
+    albo: {
+        key: "albo",
+        enterUrl: ALBO_URLS.login,
+        goalUrl: ALBO_URLS.dashboard,
+    },
+    manabo: {
+        key: "manabo",
+        enterUrl: MANABO_URLS.auth,
+        goalUrl: MANABO_URLS.auth,
+    },
+};

package/dist/esm/core/request.d.ts

@@ -0,0 +1,29 @@
+/**
+ * クライアント共通のリクエスト実行ヘルパ。
+ *
+ * SessionProvider があれば Cookie ヘッダを注入し、なければ付与しない
+ * （ブラウザ拡張では Transport 側の credentials に委ねる）。
+ */
+import type { PortalService, SessionProvider, Transport, TransportResponse } from "../types";
+import type { ZodSafeParseResult } from "zod";
+export interface RequestContext {
+    readonly transport: Transport;
+    readonly session?: SessionProvider;
+}
+export interface PortalRequestInit {
+    method: "GET" | "POST";
+    url: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}
+/** Cookie を（あれば）注入して1回リクエストする。 */
+export declare const portalRequest: (ctx: RequestContext, service: PortalService, init: PortalRequestInit) => Promise<TransportResponse>;
+/** Cookie を注入してボディ文字列だけを返す。 */
+export declare const portalRequestText: (ctx: RequestContext, service: PortalService, init: PortalRequestInit) => Promise<string>;
+/**
+ * parser の {@link ZodSafeParseResult} を DTO に unwrap する。失敗時は {@link ParseError}。
+ * 各クライアントメソッドの戻り値を「生 DTO」に統一するための共通処理。
+ */
+export declare const unwrap: <T>(result: ZodSafeParseResult<T>) => T;
+//# sourceMappingURL=request.d.ts.map

package/dist/esm/core/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/core/request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,KAAK,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,kCAAkC;AAClC,eAAO,MAAM,aAAa,GACtB,KAAK,cAAc,EACnB,SAAS,aAAa,EACtB,MAAM,iBAAiB,KACxB,OAAO,CAAC,iBAAiB,CAe3B,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,GAC1B,KAAK,cAAc,EACnB,SAAS,aAAa,EACtB,MAAM,iBAAiB,KACxB,OAAO,CAAC,MAAM,CAGhB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,QAAQ,kBAAkB,CAAC,CAAC,CAAC,KAAG,CAKzD,CAAC"}

package/dist/esm/core/request.js

@@ -0,0 +1,33 @@
+import { ParseError } from "../errors";
+/** Cookie を（あれば）注入して1回リクエストする。 */
+export 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 } : {}),
+    });
+};
+/** Cookie を注入してボディ文字列だけを返す。 */
+export const portalRequestText = async (ctx, service, init) => {
+    const res = await portalRequest(ctx, service, init);
+    return res.body;
+};
+/**
+ * parser の {@link ZodSafeParseResult} を DTO に unwrap する。失敗時は {@link ParseError}。
+ * 各クライアントメソッドの戻り値を「生 DTO」に統一するための共通処理。
+ */
+export const unwrap = (result) => {
+    if (!result.success) {
+        throw new ParseError({ cause: result.error });
+    }
+    return result.data;
+};

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

@@ -0,0 +1,13 @@
+import { type RequestContext } from "../core/request";
+import type { CubicsAsTimetableDTO } from "./types/cubics";
+export declare class CubicsClient {
+    private readonly ctx;
+    constructor(ctx: RequestContext);
+    /** セッション無効時は base 外へのリダイレクト、または "Missing cookie" タイトルが返る */
+    private isSessionValid;
+    private waitForRetryDelay;
+    private fetchText;
+    /** 週間時間割を取得する */
+    getTimetable(): Promise<CubicsAsTimetableDTO>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cubics/client.ts"],"names":[],"mappings":"AAYA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEhD,4DAA4D;IAC5D,OAAO,CAAC,cAAc;YAOR,iBAAiB;YAKjB,SAAS;IAevB,iBAAiB;IACX,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAMtD"}

package/dist/esm/cubics/client.js

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

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

@@ -0,0 +1,4 @@
+export { parseCubicsAsTimetable } from "./parser/cubics";
+export * from "./types/cubics";
+export { CubicsClient } from "./client";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cubics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/cubics/index.js

@@ -0,0 +1,3 @@
+export { parseCubicsAsTimetable } from "./parser/cubics";
+export * from "./types/cubics";
+export { CubicsClient } from "./client";