chukyo-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chukyo-umebo
+
+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,227 @@
+# chukyo-sdk
+
+中京大学ポータル（**Albo** / **CUBICS** / **MaNaBo**）のデータを、**fetch → parse → 検証済み DTO** まで一気に取得する TypeScript SDK。
+
+Node / ブラウザ / ブラウザ拡張 / Expo など環境を問わず、同じコードで動きます。
+
+> このドキュメントは**使い方**です。設計思想・内部方針は [DESIGN.md](DESIGN.md) を参照してください。
+
+## インストール
+
+```sh
+npm install chukyo-sdk
+# または
+bun add chukyo-sdk
+```
+
+`typescript ^5` を peerDependency に持ちます。
+
+## クイックスタート
+
+```ts
+import { createChukyoClient, fetchTransport } from "chukyo-sdk";
+
+const client = createChukyoClient({
+  transport: fetchTransport(),   // HTTP をどう実行するか（必須）
+  session: mySessionProvider,     // Cookie をどう供給するか（任意）
+});
+
+// 各メソッドは fetch → parse まで行い、Zod 検証済みの DTO を返す
+const timetable = await client.albo.getTimetable();
+const news = await client.albo.getInformation();
+const cubicsTimetable = await client.cubics.getTimetable();
+```
+
+`client` には `albo` / `cubics` / `manabo` の3つのポータルクライアントがぶら下がっています。
+
+## 2つの Adapter を理解する
+
+SDK は「HTTP の実行方法」と「Cookie の供給方法」を**知りません**。この2つを注入することで、あらゆる環境で同じコードが動きます。
+
+### 1. Transport（必須）— HTTP をどう実行するか
+
+`fetchTransport()` が標準実装です。環境ごとに引数を変えるだけで対応できます。
+
+```ts
+import { fetchTransport } from "chukyo-sdk";
+
+// Node 18+（globalThis.fetch を使う）
+fetchTransport();
+
+// Expo
+import { fetch as expoFetch } from "expo/fetch";
+fetchTransport(expoFetch);
+
+// ブラウザ拡張（ブラウザの Cookie ジャーを自動送信 → SessionProvider 不要）
+fetchTransport(fetch, { credentials: "include" });
+```
+
+オプション（`FetchTransportOptions`）:
+
+| オプション | 既定 | 説明 |
+| --- | --- | --- |
+| `timeoutMs` | `10000` | タイムアウト（ms） |
+| `userAgent` | なし | 付与する User-Agent（ブラウザでは無視される） |
+| `credentials` | `"omit"` | Cookie 送信ポリシー。拡張でブラウザ Cookie を使うなら `"include"` |
+| `mapErrorStatus` | 503→メンテナンス | 異常ステータスをエラーへ変換するフック |
+
+### 2. SessionProvider（任意）— Cookie をどう供給するか
+
+**この SDK はログイン（認証）を行いません。** 有効な Cookie を供給する `SessionProvider` を実装して渡します。
+
+```ts
+import type { SessionProvider, PortalService } from "chukyo-sdk";
+
+const mySessionProvider: SessionProvider = {
+  // サービスごとに HTTP ヘッダ用の Cookie 文字列を返す。失効していれば内部で再認証する
+  async getCookieHeader(service: PortalService): Promise<string> {
+    return "SESSION=...; ...";
+  },
+  // セッション無効を検知した際に SDK から呼ばれる（次回アクセスで再認証させる）
+  invalidate(serviceKey: string): void {
+    // キャッシュを破棄するなど
+  },
+};
+```
+
+**省略した場合**、SDK は Cookie ヘッダを付与せず、Transport の `credentials` 設定に委ねます。ブラウザ拡張でブラウザの Cookie ジャーを使う場合は `session` を省略し、`fetchTransport(fetch, { credentials: "include" })` を渡してください。
+
+## API リファレンス
+
+すべてのメソッドは非同期で、Zod で検証済みの DTO を返します（パース失敗時は `ParseError` を throw）。
+
+### `client.albo` — ポータルサイト（JSON REST API）
+
+3システムで唯一の本格的な JSON API を持ち、機能が最も豊富です。
+
+| メソッド | 説明 |
+| --- | --- |
+| `getTimetable()` | 時間割 |
+| `getCalendar(options?)` | 学年暦カレンダー（後述） |
+| `getCalendarSource()` | 購読中カレンダーソース一覧（学部/大学院などの UUID） |
+| `getCalendarOutlookEvent(n, options?)` | Outlook 連携イベント |
+| `getInformation(page?, pageSize?)` | お知らせ一覧 |
+| `getInformationDetail(uuid)` | お知らせ詳細 |
+| `getInformationCategoryTree()` | お知らせカテゴリのツリー |
+| `getQuestionnaire(page?, pageSize?)` | アンケート一覧 |
+| `getQuestionnaireDetail(uuid)` | アンケート詳細（設問・回答含む） |
+| `getQuestionnaireCategory()` | アンケートカテゴリ一覧 |
+| `getUniversalForm(page?, pageSize?)` | 汎用申請フォーム一覧 |
+| `getUniversalFormCategory(page?, pageSize?)` | 汎用申請カテゴリ一覧 |
+| `getMenu()` | メニュー（タブ）一覧 |
+| `getMenuDetail(uuid)` | メニュー詳細 |
+| `getMenuLayout(uuid)` | メニューのレイアウト設定 |
+| `getSystemSetting()` | システム設定一覧 |
+| `getLanguageSetting()` | 翻訳（言語）設定 |
+| `getDevice(page?, pageSize?)` | ログイン済みデバイス一覧 |
+| `getActionLog(page?, pageSize?)` | 自分の操作ログ |
+| `getSharedItem(page, folderUuid)` | 指定フォルダ配下のファイル一覧 |
+| `getPersonal()` | 個人情報（**PII を含む**） |
+| `getAuthCheck()` | ログイン確認（個人情報と同型、**PII を含む**） |
+
+`getCalendar` の主なオプション:
+
+```ts
+await client.albo.getCalendar({
+  calendarSourceUuid,  // 省略時は学年暦（学部）。getCalendarSource() で別ソースの UUID を取得
+  startAt,             // UNIX 秒。省略時は範囲指定なし（全件）
+  endAt,               // UNIX 秒
+  addOutlookCalendar,  // Outlook 連携イベントを含めるか
+  pageSize,            // 既定 1000
+});
+```
+
+### `client.cubics` — 教務システム（画面遷移型 HTML）
+
+セッションが不安定なため、無効を検知すると自動でリトライします。
+
+| メソッド | 説明 |
+| --- | --- |
+| `getTimetable()` | 週間時間割 |
+
+### `client.manabo` — 学習管理システム（Glexa ベース）
+
+授業・出席・メールなどを扱います。`classId` は時間割などから取得します。
+
+| メソッド | 説明 |
+| --- | --- |
+| `getTimetable()` | 時間割 |
+| `getClassNews(classId)` | 授業のお知らせ一覧 |
+| `getClassSyllabus(classId)` | 授業のシラバス |
+| `getClassEntry(classId)` | 授業の出席表（各回の出欠一覧） |
+| `getClassDirectory(classId)` | 授業のディレクトリ（週・回）一覧 |
+| `getClassContent(classId, directoryId, viewType?)` | ディレクトリ配下の教材一覧 |
+| `getEntryForm(classId)` | 出席受付モーダルのフォーム（後述） |
+| `submitEntry(params)` | 出席登録を送信（後述） |
+| `getReceivedMail(options?)` | 受信メール一覧 |
+| `getSentMail(options?)` | 送信メール一覧 |
+| `getMailView(mailId)` | メール本文 |
+| `searchMailMembers(q)` | メール宛先候補メンバーを検索 |
+
+出席登録の流れ:
+
+```ts
+// 1. フォームを取得
+const form = await client.manabo.getEntryForm(classId);
+
+// 2. 出席コード（パスワード）が必要かは requiresCode で判定
+await client.manabo.submitEntry({
+  classId,
+  directoryId: form.directoryId,
+  entryId: form.entryId,
+  uniqid: form.uniqid,
+  code: form.requiresCode ? "教員指示のコード" : undefined,
+});
+```
+
+## エラーハンドリング
+
+SDK が投げるエラーはすべて `ChukyoSdkError` を継承しています。`instanceof` で判別してください。
+
+```ts
+import {
+  ChukyoSdkError,
+  ParseError,           // fetch は成功したが期待スキーマに一致しない（サイト構造変化の疑い、cause に Zod エラー）
+  ExpiredSessionError,  // セッション失効。再認証を試みても回復しなかった
+  ChukyoMaintenanceError, // 大学側メンテナンス（HTTP 503）
+  NetworkError,         // ネットワーク到達失敗（DNS・接続拒否・TLS 等）
+  TimeoutError,         // リクエストがタイムアウト
+} from "chukyo-sdk";
+
+try {
+  const tt = await client.albo.getTimetable();
+} catch (e) {
+  if (e instanceof ChukyoMaintenanceError) {
+    // メンテナンス中の案内を出す
+  } else if (e instanceof ExpiredSessionError) {
+    // 再ログインを促す
+  } else if (e instanceof ChukyoSdkError) {
+    // その他 SDK エラー
+  }
+}
+```
+
+## 認証（Shibboleth）について
+
+前述のとおり SDK はログインを**実行しません**。ただし Shibboleth（SAML + パスキー等）フローを組み立てるための**構造化ヘルパ**を `shib` モジュールとして提供しています。
+
+- **ビルダ**（`buildPasswordLoginRequest` など）: 各ステップのリクエスト記述子を組み立てる
+- **パーサ**（`parseShibLoginResult` など）: レスポンスから AuthState・SAML フォーム・CSRF トークン・WebAuthn challenge・リダイレクト先などを取り出す
+
+HTTP 実行・Cookie 管理・リダイレクト追従・パスキーの鍵生成/署名は**呼び出し側の責務**です。これらを使って自前の `SessionProvider` を実装します。
+
+```ts
+import { buildPasswordLoginRequest, parseShibLoginResult, SHIB_URLS } from "chukyo-sdk";
+```
+
+## PII（個人情報）の取り扱い
+
+SDK は PII のフィルタを**行いません**。`getPersonal()` など個人情報を含むエンドポイントもそのまま取得できます。PII の保管・表示・送信の責務は利用側にあります。
+
+## 型と DTO
+
+全 DTO のフィールドには日本語の説明とサニタイズ済みの例が、JSDoc と Zod の `.meta()` の両方で付いています。エディタの補完・ホバーでそのまま確認できます。DTO 型（`AlboTimetableDTO` など）や個別の parser 関数も import 可能です。
+
+## ライセンス / 注意
+
+中京大学の各ポータルを利用規約の範囲内で利用してください。取得したデータ、特に個人情報の取り扱いには十分注意してください。

package/dist/cjs/albo/client.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlboClient = void 0;
+/**
+ * Albo クライアント。3システムで唯一まともな JSON REST API を持つ。
+ *
+ * ※ 個人情報を含むエンドポイント（auth/check-logged-in・personal）も提供する。
+ *   PII の取り扱いは利用側の責務（SDK ではフィルタしない）。
+ */
+const constants_1 = require("../constants");
+const request_1 = require("../core/request");
+const albo_1 = require("./parser/albo");
+class AlboClient {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    fetchText(path) {
+        return (0, request_1.portalRequestText)(this.ctx, constants_1.SERVICES.albo, {
+            method: "GET",
+            url: `${constants_1.ALBO_URLS.base}${path}`,
+        });
+    }
+    /**
+     * 学年暦カレンダーを取得する。
+     *
+     * `calendarSourceUuid` 省略時は {@link ALBO_DEFAULT_CALENDAR_SOURCE_UUID}（学年暦・学部）を使う。
+     * 大学院など別ソースを取りたい場合は `getCalendarSource()` で UUID を取得し、ここに渡す。
+     * `startAt` / `endAt`（UNIX 秒）省略時は範囲指定なし（ブラウザの UI は「本日〜今年度末」を渡すが、
+     * SDK としては全件取得をデフォルトにしている）。
+     */
+    async getCalendar(options = {}) {
+        const { calendarSourceUuid = constants_1.ALBO_DEFAULT_CALENDAR_SOURCE_UUID, startAt, endAt, addOutlookCalendar, pageSize = 1000, } = options;
+        const query = [
+            `page_size=${pageSize}`,
+            `calendar_source_uuid=${calendarSourceUuid}`,
+            ...(startAt != null ? [`start_at=${startAt}`] : []),
+            ...(endAt != null ? [`end_at=${endAt}`] : []),
+            ...(addOutlookCalendar != null ? [`add_outlook_calendar=${addOutlookCalendar ? "1" : "0"}`] : []),
+        ].join("&");
+        return (0, request_1.unwrap)((0, albo_1.parseAlboCalendar)(await this.fetchText(`/api/calendar/?${query}`)));
+    }
+    /** お知らせ一覧を取得する */
+    async getInformation(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboInformation)(await this.fetchText(`/api/information/${page}?page_size=${pageSize}&category_uuid=`)));
+    }
+    /** 時間割を取得する */
+    async getTimetable() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboTimetable)(await this.fetchText("/api/class/time-table/")));
+    }
+    /** ログイン確認（個人情報と同型。PII を含む） */
+    async getAuthCheck() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboAuthCheck)(await this.fetchText("/api/auth/check-logged-in")));
+    }
+    /** 個人情報を取得する（PII を含む） */
+    async getPersonal() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboPersonal)(await this.fetchText("/api/auth/check-logged-in")));
+    }
+    /** 購読中カレンダーソースの一覧を取得する */
+    async getCalendarSource() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboCalendarSource)(await this.fetchText("/api/calendar-source/")));
+    }
+    /**
+     * Outlook 連携イベントを取得する（未連携時は `result.message === "No token."` の応答）。
+     * `start_at` / `end_at` / `page_size` は実ブラウザも常に付与しているクエリで、省略はできない
+     * 前提で `startAt=0, endAt=0, pageSize=1`（＝連携有無の確認用）をデフォルトにしている。
+     */
+    async getCalendarOutlookEvent(n, options = {}) {
+        const { startAt = 0, endAt = 0, pageSize = 1 } = options;
+        return (0, request_1.unwrap)((0, albo_1.parseAlboCalendarOutlookEvent)(await this.fetchText(`/api/calendar/outlook-event/${n}?start_at=${startAt}&end_at=${endAt}&page_size=${pageSize}`)));
+    }
+    /** お知らせ詳細を取得する */
+    async getInformationDetail(uuid) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboInformationDetail)(await this.fetchText(`/api/information/view/${uuid}`)));
+    }
+    /** お知らせカテゴリのツリーを取得する */
+    async getInformationCategoryTree() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboInformationCategoryTree)(await this.fetchText("/api/information-category/tree")));
+    }
+    /** アンケート一覧を取得する */
+    async getQuestionnaire(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboQuestionnaire)(await this.fetchText(`/api/questionnaire/${page}?page_size=${pageSize}`)));
+    }
+    /** アンケート詳細（設問・回答含む）を取得する */
+    async getQuestionnaireDetail(uuid) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboQuestionnaireDetail)(await this.fetchText(`/api/questionnaire/view/${uuid}`)));
+    }
+    /** アンケートカテゴリ一覧を取得する */
+    async getQuestionnaireCategory() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboQuestionnaireCategory)(await this.fetchText("/api/questionnaire-category")));
+    }
+    /** 汎用申請フォーム一覧を取得する */
+    async getUniversalForm(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboUniversalForm)(await this.fetchText(`/api/universal-form/${page}?page_size=${pageSize}`)));
+    }
+    /** 汎用申請カテゴリ一覧を取得する */
+    async getUniversalFormCategory(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboUniversalFormCategory)(await this.fetchText(`/api/universal-form-category/${page}?page_size=${pageSize}`)));
+    }
+    /** メニュー（タブ）一覧を取得する */
+    async getMenu() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboMenu)(await this.fetchText("/api/menu")));
+    }
+    /** メニュー詳細（配置モジュール含む）を取得する */
+    async getMenuDetail(uuid) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboMenuDetail)(await this.fetchText(`/api/menu/view/${uuid}`)));
+    }
+    /** メニューのレイアウト設定を取得する */
+    async getMenuLayout(uuid) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboMenuLayout)(await this.fetchText(`/api/menu-layout/view/${uuid}`)));
+    }
+    /** システム設定一覧を取得する */
+    async getSystemSetting() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboSystemSetting)(await this.fetchText("/api/system-setting")));
+    }
+    /** 翻訳（言語）設定を取得する */
+    async getLanguageSetting() {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboLanguageSetting)(await this.fetchText("/api/language-setting/view")));
+    }
+    /** ログイン済みデバイス一覧を取得する */
+    async getDevice(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboDevice)(await this.fetchText(`/api/device/${page}?page_size=${pageSize}`)));
+    }
+    /** 自分の操作ログを取得する */
+    async getActionLog(page = 1, pageSize = 20) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboActionLog)(await this.fetchText(`/api/action-log/user-view/${page}?page_size=${pageSize}`)));
+    }
+    /** 指定フォルダ配下のファイル一覧を取得する */
+    async getSharedItem(page, folderUuid) {
+        return (0, request_1.unwrap)((0, albo_1.parseAlboSharedItem)(await this.fetchText(`/api/shared-item/${page}/${folderUuid}`)));
+    }
+}
+exports.AlboClient = AlboClient;

package/dist/cjs/albo/index.js

@@ -0,0 +1,55 @@
+"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.AlboClient = exports.AlboActionResultSchema = exports.paginationShape = exports.alboEnvelope = exports.parseAlboActionResult = exports.parseAlboSharedItem = exports.parseAlboActionLog = exports.parseAlboDevice = exports.parseAlboLanguageSetting = exports.parseAlboSystemSetting = exports.parseAlboPersonal = exports.parseAlboAuthCheck = exports.parseAlboTimetable = exports.parseAlboMenuLayout = exports.parseAlboMenuDetail = exports.parseAlboMenu = exports.parseAlboUniversalFormCategory = exports.parseAlboUniversalForm = exports.parseAlboQuestionnaireCategory = exports.parseAlboQuestionnaireDetail = exports.parseAlboQuestionnaire = exports.parseAlboInformationCategoryTree = exports.parseAlboInformationDetail = exports.parseAlboInformation = exports.parseAlboCalendarOutlookEvent = exports.parseAlboCalendarSource = exports.parseAlboCalendar = void 0;
+var albo_1 = require("./parser/albo");
+Object.defineProperty(exports, "parseAlboCalendar", { enumerable: true, get: function () { return albo_1.parseAlboCalendar; } });
+Object.defineProperty(exports, "parseAlboCalendarSource", { enumerable: true, get: function () { return albo_1.parseAlboCalendarSource; } });
+Object.defineProperty(exports, "parseAlboCalendarOutlookEvent", { enumerable: true, get: function () { return albo_1.parseAlboCalendarOutlookEvent; } });
+Object.defineProperty(exports, "parseAlboInformation", { enumerable: true, get: function () { return albo_1.parseAlboInformation; } });
+Object.defineProperty(exports, "parseAlboInformationDetail", { enumerable: true, get: function () { return albo_1.parseAlboInformationDetail; } });
+Object.defineProperty(exports, "parseAlboInformationCategoryTree", { enumerable: true, get: function () { return albo_1.parseAlboInformationCategoryTree; } });
+Object.defineProperty(exports, "parseAlboQuestionnaire", { enumerable: true, get: function () { return albo_1.parseAlboQuestionnaire; } });
+Object.defineProperty(exports, "parseAlboQuestionnaireDetail", { enumerable: true, get: function () { return albo_1.parseAlboQuestionnaireDetail; } });
+Object.defineProperty(exports, "parseAlboQuestionnaireCategory", { enumerable: true, get: function () { return albo_1.parseAlboQuestionnaireCategory; } });
+Object.defineProperty(exports, "parseAlboUniversalForm", { enumerable: true, get: function () { return albo_1.parseAlboUniversalForm; } });
+Object.defineProperty(exports, "parseAlboUniversalFormCategory", { enumerable: true, get: function () { return albo_1.parseAlboUniversalFormCategory; } });
+Object.defineProperty(exports, "parseAlboMenu", { enumerable: true, get: function () { return albo_1.parseAlboMenu; } });
+Object.defineProperty(exports, "parseAlboMenuDetail", { enumerable: true, get: function () { return albo_1.parseAlboMenuDetail; } });
+Object.defineProperty(exports, "parseAlboMenuLayout", { enumerable: true, get: function () { return albo_1.parseAlboMenuLayout; } });
+Object.defineProperty(exports, "parseAlboTimetable", { enumerable: true, get: function () { return albo_1.parseAlboTimetable; } });
+Object.defineProperty(exports, "parseAlboAuthCheck", { enumerable: true, get: function () { return albo_1.parseAlboAuthCheck; } });
+Object.defineProperty(exports, "parseAlboPersonal", { enumerable: true, get: function () { return albo_1.parseAlboPersonal; } });
+Object.defineProperty(exports, "parseAlboSystemSetting", { enumerable: true, get: function () { return albo_1.parseAlboSystemSetting; } });
+Object.defineProperty(exports, "parseAlboLanguageSetting", { enumerable: true, get: function () { return albo_1.parseAlboLanguageSetting; } });
+Object.defineProperty(exports, "parseAlboDevice", { enumerable: true, get: function () { return albo_1.parseAlboDevice; } });
+Object.defineProperty(exports, "parseAlboActionLog", { enumerable: true, get: function () { return albo_1.parseAlboActionLog; } });
+Object.defineProperty(exports, "parseAlboSharedItem", { enumerable: true, get: function () { return albo_1.parseAlboSharedItem; } });
+Object.defineProperty(exports, "parseAlboActionResult", { enumerable: true, get: function () { return albo_1.parseAlboActionResult; } });
+__exportStar(require("./types/albo"), exports);
+__exportStar(require("./types/alboCalendar"), exports);
+__exportStar(require("./types/alboInformation"), exports);
+__exportStar(require("./types/alboQuestionnaire"), exports);
+__exportStar(require("./types/alboUniversalForm"), exports);
+__exportStar(require("./types/alboMenu"), exports);
+__exportStar(require("./types/alboSystem"), exports);
+__exportStar(require("./types/alboSharedItem"), exports);
+var alboCommon_1 = require("./types/alboCommon");
+Object.defineProperty(exports, "alboEnvelope", { enumerable: true, get: function () { return alboCommon_1.alboEnvelope; } });
+Object.defineProperty(exports, "paginationShape", { enumerable: true, get: function () { return alboCommon_1.paginationShape; } });
+Object.defineProperty(exports, "AlboActionResultSchema", { enumerable: true, get: function () { return alboCommon_1.AlboActionResultSchema; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "AlboClient", { enumerable: true, get: function () { return client_1.AlboClient; } });

package/dist/cjs/albo/parser/albo.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAlboActionResult = exports.parseAlboTimetable = exports.parseAlboSharedItem = exports.parseAlboActionLog = exports.parseAlboDevice = exports.parseAlboLanguageSetting = exports.parseAlboSystemSetting = exports.parseAlboPersonal = exports.parseAlboAuthCheck = exports.parseAlboMenuLayout = exports.parseAlboMenuDetail = exports.parseAlboMenu = exports.parseAlboUniversalFormCategory = exports.parseAlboUniversalForm = exports.parseAlboQuestionnaireCategory = exports.parseAlboQuestionnaireDetail = exports.parseAlboQuestionnaire = exports.parseAlboInformationCategoryTree = exports.parseAlboInformationDetail = exports.parseAlboInformation = exports.parseAlboCalendarOutlookEvent = exports.parseAlboCalendarSource = exports.parseAlboCalendar = void 0;
+const albo_1 = require("../types/albo");
+const alboCommon_1 = require("../types/alboCommon");
+const alboCalendar_1 = require("../types/alboCalendar");
+const alboInformation_1 = require("../types/alboInformation");
+const alboQuestionnaire_1 = require("../types/alboQuestionnaire");
+const alboUniversalForm_1 = require("../types/alboUniversalForm");
+const alboMenu_1 = require("../types/alboMenu");
+const alboSystem_1 = require("../types/alboSystem");
+const alboSharedItem_1 = require("../types/alboSharedItem");
+/**
+ * albo API の JSON 文字列を安全にパースする共通ヘルパー。
+ * JSON として不正な入力でも例外を投げず、`ZodSafeParseResult`（success/error）を返す。
+ */
+const parseAlboJson = (input, schema) => {
+    try {
+        return schema.safeParse(JSON.parse(input));
+    }
+    catch {
+        return schema.safeParse(undefined);
+    }
+};
+// --- カレンダー（calendar） ---------------------------------------------------
+/** GET /api/calendar/ … 学年暦カレンダーのイベント一覧 */
+const parseAlboCalendar = (json) => parseAlboJson(json, albo_1.AlboCalendarSchema);
+exports.parseAlboCalendar = parseAlboCalendar;
+/** GET /api/calendar-source/ … 購読中カレンダーソースの一覧 */
+const parseAlboCalendarSource = (json) => parseAlboJson(json, alboCalendar_1.AlboCalendarSourceSchema);
+exports.parseAlboCalendarSource = parseAlboCalendarSource;
+/** GET /api/calendar/outlook-event/{n} … Outlook 連携イベント（未連携時はエラー応答） */
+const parseAlboCalendarOutlookEvent = (json) => parseAlboJson(json, alboCalendar_1.AlboCalendarOutlookEventSchema);
+exports.parseAlboCalendarOutlookEvent = parseAlboCalendarOutlookEvent;
+// --- お知らせ（information） -------------------------------------------------
+/** GET /api/information/{page} … お知らせ一覧 */
+const parseAlboInformation = (json) => parseAlboJson(json, albo_1.AlboInformationSchema);
+exports.parseAlboInformation = parseAlboInformation;
+/** GET /api/information/view/{uuid} … お知らせ詳細 */
+const parseAlboInformationDetail = (json) => parseAlboJson(json, alboInformation_1.AlboInformationDetailSchema);
+exports.parseAlboInformationDetail = parseAlboInformationDetail;
+/** GET /api/information-category/tree … お知らせカテゴリのツリー */
+const parseAlboInformationCategoryTree = (json) => parseAlboJson(json, alboInformation_1.AlboInformationCategoryTreeSchema);
+exports.parseAlboInformationCategoryTree = parseAlboInformationCategoryTree;
+// --- アンケート（questionnaire） --------------------------------------------
+/** GET /api/questionnaire/{page} … アンケート一覧 */
+const parseAlboQuestionnaire = (json) => parseAlboJson(json, alboQuestionnaire_1.AlboQuestionnaireSchema);
+exports.parseAlboQuestionnaire = parseAlboQuestionnaire;
+/** GET /api/questionnaire/view/{uuid}, PUT /api/questionnaire/answer/{uuid} … アンケート詳細／回答結果 */
+const parseAlboQuestionnaireDetail = (json) => parseAlboJson(json, alboQuestionnaire_1.AlboQuestionnaireDetailSchema);
+exports.parseAlboQuestionnaireDetail = parseAlboQuestionnaireDetail;
+/** GET /api/questionnaire-category … アンケートカテゴリ一覧 */
+const parseAlboQuestionnaireCategory = (json) => parseAlboJson(json, alboQuestionnaire_1.AlboQuestionnaireCategoryListSchema);
+exports.parseAlboQuestionnaireCategory = parseAlboQuestionnaireCategory;
+// --- 汎用申請（universal-form） ---------------------------------------------
+/** GET /api/universal-form/{page} … 申請フォーム一覧 */
+const parseAlboUniversalForm = (json) => parseAlboJson(json, alboUniversalForm_1.AlboUniversalFormSchema);
+exports.parseAlboUniversalForm = parseAlboUniversalForm;
+/** GET /api/universal-form-category/{page} … 申請カテゴリ一覧 */
+const parseAlboUniversalFormCategory = (json) => parseAlboJson(json, alboUniversalForm_1.AlboUniversalFormCategoryListSchema);
+exports.parseAlboUniversalFormCategory = parseAlboUniversalFormCategory;
+// --- メニュー（menu） -------------------------------------------------------
+/** GET /api/menu … メニュー（タブ）一覧 */
+const parseAlboMenu = (json) => parseAlboJson(json, alboMenu_1.AlboMenuSchema);
+exports.parseAlboMenu = parseAlboMenu;
+/** GET /api/menu/view/{uuid} … メニュー詳細（配置モジュール含む） */
+const parseAlboMenuDetail = (json) => parseAlboJson(json, alboMenu_1.AlboMenuDetailSchema);
+exports.parseAlboMenuDetail = parseAlboMenuDetail;
+/** GET /api/menu-layout/view/{uuid}, POST /api/menu-layout/save/{uuid} … レイアウト設定 */
+const parseAlboMenuLayout = (json) => parseAlboJson(json, alboMenu_1.AlboMenuLayoutSchema);
+exports.parseAlboMenuLayout = parseAlboMenuLayout;
+// --- システム設定・アカウント（system） ------------------------------------
+/** GET /api/auth/check-logged-in … ログイン確認（レスポンスは個人情報と同型。PII を含む） */
+const parseAlboAuthCheck = (json) => parseAlboJson(json, albo_1.AlboPersonalSchema);
+exports.parseAlboAuthCheck = parseAlboAuthCheck;
+/** ログイン後の個人情報（PII を含む） */
+const parseAlboPersonal = (json) => parseAlboJson(json, albo_1.AlboPersonalSchema);
+exports.parseAlboPersonal = parseAlboPersonal;
+/** GET /api/system-setting … システム設定一覧 */
+const parseAlboSystemSetting = (json) => parseAlboJson(json, alboSystem_1.AlboSystemSettingSchema);
+exports.parseAlboSystemSetting = parseAlboSystemSetting;
+/** GET /api/language-setting/view … 翻訳（言語）設定 */
+const parseAlboLanguageSetting = (json) => parseAlboJson(json, alboSystem_1.AlboLanguageSettingSchema);
+exports.parseAlboLanguageSetting = parseAlboLanguageSetting;
+/** GET /api/device/{page} … ログイン済みデバイス一覧 */
+const parseAlboDevice = (json) => parseAlboJson(json, alboSystem_1.AlboDeviceSchema);
+exports.parseAlboDevice = parseAlboDevice;
+/** GET /api/action-log/user-view/{page} … 自分の操作ログ */
+const parseAlboActionLog = (json) => parseAlboJson(json, alboSystem_1.AlboActionLogSchema);
+exports.parseAlboActionLog = parseAlboActionLog;
+// --- ファイル共有（shared-item） --------------------------------------------
+/** GET /api/shared-item/{page}/{folderUuid} … フォルダ配下のファイル一覧 */
+const parseAlboSharedItem = (json) => parseAlboJson(json, alboSharedItem_1.AlboSharedItemListSchema);
+exports.parseAlboSharedItem = parseAlboSharedItem;
+// --- 時間割（timetable） ----------------------------------------------------
+/** GET /api/class/time-table/ … 時間割 */
+const parseAlboTimetable = (json) => parseAlboJson(json, albo_1.AlboTimetableSchema);
+exports.parseAlboTimetable = parseAlboTimetable;
+// --- 汎用操作結果（action result） ------------------------------------------
+/**
+ * 既読化・ピン留め・いいね・ダウンロード準備・デバイス削除などの操作系 API が返す
+ * 汎用の結果（`{ message, count? }`）をパースする。対象エンドポイント例:
+ *   - GET  /api/information/set-read-all/
+ *   - GET  /api/information/add-good/{uuid}
+ *   - PUT  /api/information/set-pin-selected/  など set/unset-*-selected 一式
+ *   - POST /api/shared-item/prepare-multiple-download/
+ *   - DELETE /api/device/delete/{id}
+ */
+const parseAlboActionResult = (json) => parseAlboJson(json, alboCommon_1.AlboActionResultSchema);
+exports.parseAlboActionResult = parseAlboActionResult;