chukyo-sdk 0.1.0

package/dist/cjs/albo/types/albo.js

@@ -0,0 +1,351 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlboPersonalSchema = exports.AlboPersonalUserSchema = exports.AlboPersonalGroupSchema = exports.AlboPersonalAuthProfileSchema = exports.AlboInformationSchema = exports.AlboInformationItemSchema = exports.AlboInformationFileSchema = exports.AlboInformationCategorySchema = exports.AlboTimetableSchema = exports.AlboTimetableItemSchema = exports.AlboTimetableBadgeSchema = exports.AlboCalendarSchema = exports.AlboCalendarItemSchema = void 0;
+const zod_1 = require("zod");
+const alboCommon_1 = require("./alboCommon");
+// albo の各 API レスポンスをそのまま検証・保持するスキーマ群。
+// フィールド名は API が返すキーそのまま、値は無変換で通す（パススルー）。
+// --- カレンダー（学年暦） ---------------------------------------------------
+/** 学年暦カレンダーの 1 イベント */
+exports.AlboCalendarItemSchema = zod_1.z.object({
+    /** カレンダーソースの UUID @example "ac304d66-b0a8-11f0-afed-06347f3ce845" */
+    calendar_source_uuid: zod_1.z.string().meta({ description: "カレンダーソースの UUID", example: "ac304d66-b0a8-11f0-afed-06347f3ce845" }),
+    /** イベント名 @example "天皇誕生日（祝日）" */
+    summary: zod_1.z.string().meta({ description: "イベント名", example: "天皇誕生日（祝日）" }),
+    /** 補足説明（無ければ null） @example "全学休講" */
+    description: zod_1.z.string().nullable().meta({ description: "補足説明", example: "全学休講" }),
+    /** 開始日時（UNIX 秒） @example 1783445975 */
+    start_at: zod_1.z.number().meta({ description: "開始日時（UNIX 秒）", example: 1783445975 }),
+    /** 終了日時（UNIX 秒） @example 1783532375 */
+    end_at: zod_1.z.number().meta({ description: "終了日時（UNIX 秒）", example: 1783532375 }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+});
+/** 学年暦カレンダー取得 API のレスポンス全体 */
+exports.AlboCalendarSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    ...alboCommon_1.paginationShape,
+    /** カレンダー名 @example "学年暦（学部）" */
+    source_name: zod_1.z.string().meta({ description: "カレンダー名", example: "学年暦（学部）" }),
+    /** イベント配列 */
+    items: zod_1.z.array(exports.AlboCalendarItemSchema).meta({ description: "イベント配列" }),
+}));
+// --- 時間割 -----------------------------------------------------------------
+/** 時間割項目に付くバッジ（学期区分など） */
+exports.AlboTimetableBadgeSchema = zod_1.z.object({
+    /** 学期表記 @example "春学期" */
+    term: zod_1.z.string().meta({ description: "学期表記", example: "春学期" }),
+});
+/** 時間割の 1 コマ（授業の 1 開講回） */
+exports.AlboTimetableItemSchema = zod_1.z.object({
+    /** コマの UUID @example "11111111-2222-3333-4444-555555555555" */
+    uuid: zod_1.z.string().meta({ description: "コマの UUID", example: "11111111-2222-3333-4444-555555555555" }),
+    /** コマの ID @example "123456" */
+    id: zod_1.z.string().meta({ description: "コマの ID", example: "123456" }),
+    /** 実施日 @example "2025-06-16" */
+    execute_date: zod_1.z.string().meta({ description: "実施日", example: "2025-06-16" }),
+    /** 曜日（0=日 〜 6=土） @example 1 */
+    day_of_week: zod_1.z.number().meta({ description: "曜日（0=日〜6=土）", example: 1 }),
+    /** 時限番号 @example 2 */
+    time_number: zod_1.z.number().meta({ description: "時限番号", example: 2 }),
+    /** 授業 ID @example "20250001" */
+    class_id: zod_1.z.string().meta({ description: "授業 ID", example: "20250001" }),
+    /** 授業名 @example "情報リテラシー" */
+    class_name: zod_1.z.string().meta({ description: "授業名", example: "情報リテラシー" }),
+    /** 学期表記 @example "春学期" */
+    term: zod_1.z.string().meta({ description: "学期表記", example: "春学期" }),
+    /** キャンパス @example "名古屋" */
+    campus: zod_1.z.string().meta({ description: "キャンパス", example: "名古屋" }),
+    /** 担当教員 @example "中京 一郎" */
+    teacher: zod_1.z.string().meta({ description: "担当教員", example: "中京 一郎" }),
+    /** 教室（無ければ null） @example "0号館5F" */
+    room: zod_1.z.string().nullable().meta({ description: "教室", example: "0号館5F" }),
+    /** メモ @example "" */
+    memo: zod_1.z.string().meta({ description: "メモ", example: "" }),
+    /** 任意オプション（未使用時 null） */
+    options: zod_1.z.unknown().nullable().meta({ description: "任意オプション" }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 実施年度 @example "2025" */
+    execute_school_year: zod_1.z.string().meta({ description: "実施年度", example: "2025" }),
+    /** 授業種別（数値コード） @example 0 */
+    class_type: zod_1.z.number().meta({ description: "授業種別（数値コード）", example: 0 }),
+    /** メモ（英語。無ければ null） @example null */
+    memo_en: zod_1.z.string().nullable().meta({ description: "メモ（英語）", example: null }),
+    /** オプション（英語。未使用時 null） */
+    options_en: zod_1.z.unknown().nullable().meta({ description: "オプション（英語）" }),
+    /** 表示順 @example 0 */
+    order: zod_1.z.number().meta({ description: "表示順", example: 0 }),
+    /** バッジ情報 */
+    badge: exports.AlboTimetableBadgeSchema,
+    /** 学期表記（英語） @example "Spring" */
+    term_en: zod_1.z.string().meta({ description: "学期表記（英語）", example: "Spring" }),
+    /** 授業名（英語） @example "Information Literacy" */
+    class_name_en: zod_1.z.string().meta({ description: "授業名（英語）", example: "Information Literacy" }),
+    /** キャンパス（英語） @example "Nagoya" */
+    campus_en: zod_1.z.string().meta({ description: "キャンパス（英語）", example: "Nagoya" }),
+    /** 休講情報の配列 */
+    cancels: zod_1.z.array(zod_1.z.unknown()).meta({ description: "休講情報の配列" }),
+    /** 補講情報の配列 */
+    extras: zod_1.z.array(zod_1.z.unknown()).meta({ description: "補講情報の配列" }),
+    /** 変更情報の配列 */
+    changes: zod_1.z.array(zod_1.z.unknown()).meta({ description: "変更情報の配列" }),
+});
+/** 時間割取得 API のレスポンス全体 */
+exports.AlboTimetableSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    /** 時間割の種別 @example "student" */
+    time_table_type: zod_1.z.string().meta({ description: "時間割の種別", example: "student" }),
+    ...alboCommon_1.paginationShape,
+    /** 時間割コマの配列 */
+    items: zod_1.z.array(exports.AlboTimetableItemSchema).meta({ description: "時間割コマの配列" }),
+}));
+// --- お知らせ ---------------------------------------------------------------
+/** お知らせのカテゴリ */
+exports.AlboInformationCategorySchema = zod_1.z.object({
+    /** カテゴリ UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    uuid: zod_1.z.string().meta({ description: "カテゴリ UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** カテゴリ名 @example "教務課からのお知らせ" */
+    name: zod_1.z.string().meta({ description: "カテゴリ名", example: "教務課からのお知らせ" }),
+    /** カテゴリ名（英語。無ければ null） @example null */
+    name_en: zod_1.z.string().nullable().meta({ description: "カテゴリ名（英語）", example: null }),
+    /** 説明（無ければ null） @example null */
+    description: zod_1.z.string().nullable().meta({ description: "説明", example: null }),
+    /** 説明（英語。無ければ null） @example null */
+    description_en: zod_1.z.string().nullable().meta({ description: "説明（英語）", example: null }),
+    /** 表示順 @example 0 */
+    order: zod_1.z.number().meta({ description: "表示順", example: 0 }),
+    /** ゲスト向けに公開するか @example false */
+    is_for_guest: zod_1.z.boolean().meta({ description: "ゲスト向けに公開するか", example: false }),
+    /** 作成者 @example "system" */
+    created_by: zod_1.z.string().meta({ description: "作成者", example: "system" }),
+    /** 更新者（無ければ null） @example null */
+    updated_by: zod_1.z.string().nullable().meta({ description: "更新者", example: null }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: zod_1.z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+});
+/** お知らせに添付されるファイル */
+exports.AlboInformationFileSchema = zod_1.z.object({
+    /** ファイル UUID @example "ffffffff-1111-2222-3333-444444444444" */
+    uuid: zod_1.z.string().meta({ description: "ファイル UUID", example: "ffffffff-1111-2222-3333-444444444444" }),
+    /** ファイル名 @example "履修案内.pdf" */
+    file_name: zod_1.z.string().meta({ description: "ファイル名", example: "履修案内.pdf" }),
+    /** MIME タイプ @example "application/pdf" */
+    mime_type: zod_1.z.string().meta({ description: "MIME タイプ", example: "application/pdf" }),
+    /** サムネイル存在フラグ @example false */
+    is_thumb_exists: zod_1.z.boolean().meta({ description: "サムネイル存在フラグ", example: false }),
+    /** 作成者 @example "system" */
+    created_by: zod_1.z.string().meta({ description: "作成者", example: "system" }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+});
+/** お知らせ 1 件 */
+exports.AlboInformationItemSchema = zod_1.z.object({
+    /** お知らせ UUID @example "12345678-90ab-cdef-1234-567890abcdef" */
+    uuid: zod_1.z.string().meta({ description: "お知らせ UUID", example: "12345678-90ab-cdef-1234-567890abcdef" }),
+    /** 発信元（部署名など） @example "教務課" */
+    publish_from: zod_1.z.string().meta({ description: "発信元", example: "教務課" }),
+    /** 発信元（英語。無ければ null） @example null */
+    publish_from_en: zod_1.z.string().nullable().meta({ description: "発信元（英語）", example: null }),
+    /** 発信部署（英語。無ければ null） @example null */
+    publish_department_en: zod_1.z.string().nullable().meta({ description: "発信部署（英語）", example: null }),
+    /** 掲載開始日時（UNIX 秒） @example 1783445975 */
+    publish_start_at: zod_1.z.number().meta({ description: "掲載開始日時（UNIX 秒）", example: 1783445975 }),
+    /** 掲載終了日時（UNIX 秒） @example 1785000000 */
+    publish_end_at: zod_1.z.number().meta({ description: "掲載終了日時（UNIX 秒）", example: 1785000000 }),
+    /** タイトル @example "定期試験の実施について" */
+    title: zod_1.z.string().meta({ description: "タイトル", example: "定期試験の実施について" }),
+    /** タイトル（英語。無ければ null） @example null */
+    title_en: zod_1.z.string().nullable().meta({ description: "タイトル（英語）", example: null }),
+    /** 本文（HTML） @example "<p>本文...</p>" */
+    content: zod_1.z.string().meta({ description: "本文（HTML）", example: "<p>本文...</p>" }),
+    /** 本文（英語。無ければ null） @example null */
+    content_en: zod_1.z.string().nullable().meta({ description: "本文（英語）", example: null }),
+    /** 優先度 @example 0 */
+    priority: zod_1.z.number().meta({ description: "優先度", example: 0 }),
+    /** イベント名（無ければ null） @example null */
+    event_title: zod_1.z.string().nullable().meta({ description: "イベント名", example: null }),
+    /** イベント名（英語。無ければ null） @example null */
+    event_title_en: zod_1.z.string().nullable().meta({ description: "イベント名（英語）", example: null }),
+    /** イベント開始日時（UNIX 秒。無ければ null） @example null */
+    event_start_at: zod_1.z.number().nullable().meta({ description: "イベント開始日時（UNIX 秒）", example: null }),
+    /** イベント終了日時（UNIX 秒。無ければ null） @example null */
+    event_end_at: zod_1.z.number().nullable().meta({ description: "イベント終了日時（UNIX 秒）", example: null }),
+    /** メール通知を送るか（0/1） @example 0 */
+    is_send_mail_notification: zod_1.z.number().meta({ description: "メール通知を送るか（0/1）", example: 0 }),
+    /** 通知メールの差出人（無ければ null） @example null */
+    mail_from: zod_1.z.string().nullable().meta({ description: "通知メールの差出人", example: null }),
+    /** 任意オプション（未使用時 null） */
+    options: zod_1.z.unknown().nullable().meta({ description: "任意オプション" }),
+    /** 作成者 @example "kyomu" */
+    created_by: zod_1.z.string().meta({ description: "作成者", example: "kyomu" }),
+    /** 更新者（無ければ null） @example null */
+    updated_by: zod_1.z.string().nullable().meta({ description: "更新者", example: null }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** テンプレートか（0/1） @example 0 */
+    is_template: zod_1.z.number().meta({ description: "テンプレートか（0/1）", example: 0 }),
+    /** 公開中か @example true */
+    is_public: zod_1.z.boolean().meta({ description: "公開中か", example: true }),
+    /** 既読か @example false */
+    is_read: zod_1.z.boolean().meta({ description: "既読か", example: false }),
+    /** ピン留めされているか @example false */
+    is_pinned: zod_1.z.boolean().meta({ description: "ピン留めされているか", example: false }),
+    /** 「いいね」済みか @example false */
+    is_reacted_good: zod_1.z.boolean().meta({ description: "「いいね」済みか", example: false }),
+    /** 「いいね」数 @example 0 */
+    good_count: zod_1.z.number().meta({ description: "「いいね」数", example: 0 }),
+    /** カテゴリ */
+    category: exports.AlboInformationCategorySchema,
+    /** 添付ファイル（無ければ null） @example null */
+    files: zod_1.z.array(exports.AlboInformationFileSchema).nullable().meta({ description: "添付ファイル", example: null }),
+    /** 個人向け添付ファイル（無ければ null） @example null */
+    personal_files: zod_1.z.array(exports.AlboInformationFileSchema).nullable().meta({ description: "個人向け添付ファイル", example: null }),
+    /** 本文中の画像（無ければ null） @example null */
+    images: zod_1.z.array(exports.AlboInformationFileSchema).nullable().meta({ description: "本文中の画像", example: null }),
+});
+/** お知らせ一覧取得 API のレスポンス全体 */
+exports.AlboInformationSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    ...alboCommon_1.paginationShape,
+    /** お知らせ配列 */
+    items: zod_1.z.array(exports.AlboInformationItemSchema).meta({ description: "お知らせ配列" }),
+}));
+// --- 個人情報（PII を含む。auth/check-logged-in も同型） ---------------------
+/** ユーザーに割り当てられた認証プロファイル */
+exports.AlboPersonalAuthProfileSchema = zod_1.z.object({
+    /** プロファイル UUID @example "00000000-0000-0000-0000-000000000000" */
+    uuid: zod_1.z.string().meta({ description: "プロファイル UUID", example: "00000000-0000-0000-0000-000000000000" }),
+    /** プロファイル名 @example "学生" */
+    name: zod_1.z.string().meta({ description: "プロファイル名", example: "学生" }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒。無ければ null） @example null */
+    updated_at: zod_1.z.number().nullable().meta({ description: "更新日時（UNIX 秒）", example: null }),
+});
+/** ユーザーが所属するグループ */
+exports.AlboPersonalGroupSchema = zod_1.z.object({
+    /** グループのインデックス @example "1" */
+    group_index: zod_1.z.string().meta({ description: "グループのインデックス", example: "1" }),
+    /** 次のグループインデックス @example "2" */
+    next_group_index: zod_1.z.string().meta({ description: "次のグループインデックス", example: "2" }),
+    /** 元のグループインデックス @example "1" */
+    orig_group_index: zod_1.z.string().meta({ description: "元のグループインデックス", example: "1" }),
+    /** グループ UUID @example "99999999-8888-7777-6666-555555555555" */
+    uuid: zod_1.z.string().meta({ description: "グループ UUID", example: "99999999-8888-7777-6666-555555555555" }),
+    /** グループ名 @example "工学部" */
+    name: zod_1.z.string().meta({ description: "グループ名", example: "工学部" }),
+    /** グループ名（英語。無ければ null） @example null */
+    name_en: zod_1.z.string().nullable().meta({ description: "グループ名（英語）", example: null }),
+    /** 権限グループか @example false */
+    is_authority: zod_1.z.boolean().meta({ description: "権限グループか", example: false }),
+    /** 表示順 @example 0 */
+    order: zod_1.z.number().meta({ description: "表示順", example: 0 }),
+    /** 有効フラグ（0/1） @example 1 */
+    is_active: zod_1.z.number().meta({ description: "有効フラグ（0/1）", example: 1 }),
+    /** サインアップ画面に表示するか（0/1） @example 0 */
+    is_shown_in_signup: zod_1.z.number().meta({ description: "サインアップ画面に表示するか（0/1）", example: 0 }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: zod_1.z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+    /** グループの正式名 @example "工学部 情報工学科" */
+    full_name: zod_1.z.string().meta({ description: "グループの正式名", example: "工学部 情報工学科" }),
+    /** 表示名 @example "情報工学科" */
+    display_name: zod_1.z.string().meta({ description: "表示名", example: "情報工学科" }),
+    /** 表示名（英語） @example "Dept. of Information Engineering" */
+    display_name_en: zod_1.z.string().meta({ description: "表示名（英語）", example: "Dept. of Information Engineering" }),
+});
+/** ログインユーザーの個人情報 */
+exports.AlboPersonalUserSchema = zod_1.z.object({
+    /** ユーザー UUID @example "aaaaaaaa-0000-0000-0000-000000000000" */
+    uuid: zod_1.z.string().meta({ description: "ユーザー UUID", example: "aaaaaaaa-0000-0000-0000-000000000000" }),
+    /** 個人 ID（学籍番号など） @example "T000000" */
+    personal_id: zod_1.z.string().meta({ description: "個人 ID（学籍番号など）", example: "T000000" }),
+    /** 氏名 @example "田中太郎" */
+    name: zod_1.z.string().meta({ description: "氏名", example: "田中太郎" }),
+    /** 氏名（カナ） @example "タナカタロウ" */
+    name_kana: zod_1.z.string().meta({ description: "氏名（カナ）", example: "タナカタロウ" }),
+    /** 氏名（アルファベット） @example "TANAKA TARO" */
+    name_alphabet: zod_1.z.string().meta({ description: "氏名（アルファベット）", example: "TANAKA TARO" }),
+    /** メールアドレス @example "t000000@m.chukyo-u.ac.jp" */
+    email: zod_1.z.string().meta({ description: "メールアドレス", example: "t000000@m.chukyo-u.ac.jp" }),
+    /** ロケール @example "ja" */
+    locale: zod_1.z.string().meta({ description: "ロケール", example: "ja" }),
+    /** 任意項目 1（無ければ null） @example null */
+    option_1: zod_1.z.string().nullable().meta({ description: "任意項目 1", example: null }),
+    /** 任意項目 2（無ければ null） @example null */
+    option_2: zod_1.z.string().nullable().meta({ description: "任意項目 2", example: null }),
+    /** 任意項目 3（無ければ null） @example null */
+    option_3: zod_1.z.string().nullable().meta({ description: "任意項目 3", example: null }),
+    /** 任意項目 4（無ければ null） @example null */
+    option_4: zod_1.z.string().nullable().meta({ description: "任意項目 4", example: null }),
+    /** 任意項目 5（無ければ null） @example null */
+    option_5: zod_1.z.string().nullable().meta({ description: "任意項目 5", example: null }),
+    /** 任意項目 6（無ければ null） @example null */
+    option_6: zod_1.z.string().nullable().meta({ description: "任意項目 6", example: null }),
+    /** 任意項目 7（無ければ null） @example null */
+    option_7: zod_1.z.string().nullable().meta({ description: "任意項目 7", example: null }),
+    /** 任意項目 8（無ければ null） @example null */
+    option_8: zod_1.z.string().nullable().meta({ description: "任意項目 8", example: null }),
+    /** 任意項目 9（無ければ null） @example null */
+    option_9: zod_1.z.string().nullable().meta({ description: "任意項目 9", example: null }),
+    /** 任意項目 10（無ければ null） @example null */
+    option_10: zod_1.z.string().nullable().meta({ description: "任意項目 10", example: null }),
+    /** 承認状態（無ければ null） @example null */
+    approval_status: zod_1.z.string().nullable().meta({ description: "承認状態", example: null }),
+    /** ユーザーが有効か @example true */
+    is_user_enabled: zod_1.z.boolean().meta({ description: "ユーザーが有効か", example: true }),
+    /** ログインが有効か @example true */
+    is_login_enabled: zod_1.z.boolean().meta({ description: "ログインが有効か", example: true }),
+    /** ゲストか @example false */
+    is_guest: zod_1.z.boolean().meta({ description: "ゲストか", example: false }),
+    /** 利用開始日時（UNIX 秒） @example 1680000000 */
+    start_at: zod_1.z.number().meta({ description: "利用開始日時（UNIX 秒）", example: 1680000000 }),
+    /** 利用終了日時（UNIX 秒） @example 1900000000 */
+    end_at: zod_1.z.number().meta({ description: "利用終了日時（UNIX 秒）", example: 1900000000 }),
+    /** メモ（無ければ null） @example null */
+    memo: zod_1.z.string().nullable().meta({ description: "メモ", example: null }),
+    /** 管理者メモ（無ければ null） @example null */
+    admin_memo: zod_1.z.string().nullable().meta({ description: "管理者メモ", example: null }),
+    /** CSV 削除対象外フラグ @example false */
+    is_not_delete_csv: zod_1.z.boolean().meta({ description: "CSV 削除対象外フラグ", example: false }),
+    /** 作成日時（UNIX 秒） @example 1680000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1680000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: zod_1.z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+    /** ログイン用ユーザー ID @example "t000000" */
+    user_id: zod_1.z.string().meta({ description: "ログイン用ユーザー ID", example: "t000000" }),
+    /** 認証プロファイル */
+    auth_profiles: exports.AlboPersonalAuthProfileSchema,
+    /** 所属グループ一覧 */
+    groups: zod_1.z.array(exports.AlboPersonalGroupSchema).meta({ description: "所属グループ一覧" }),
+    /** 必須アンケートへ回答済みか @example true */
+    has_answer_force_questionnaire: zod_1.z.boolean().meta({ description: "必須アンケートへ回答済みか", example: true }),
+    /** 必須アンケートがあるか @example false */
+    has_force_questionnaire: zod_1.z.boolean().meta({ description: "必須アンケートがあるか", example: false }),
+    /** サブメールアドレス一覧 @example [] */
+    sub_email_addresses: zod_1.z.array(zod_1.z.string()).meta({ description: "サブメールアドレス一覧", example: [] }),
+    /** 表示用グループ名一覧 @example ["工学部 情報工学科"] */
+    display_group_names: zod_1.z.array(zod_1.z.string()).meta({ description: "表示用グループ名一覧", example: ["工学部 情報工学科"] }),
+    /** 表示用グループ名一覧（英語） @example [] */
+    display_group_names_en: zod_1.z.array(zod_1.z.string()).meta({ description: "表示用グループ名一覧（英語）", example: [] }),
+    /** プロフィール画像（無ければ null） @example null */
+    portrait: zod_1.z.string().nullable().meta({ description: "プロフィール画像", example: null }),
+    /** 権限区分 @example "student" */
+    permission: zod_1.z.string().meta({ description: "権限区分", example: "student" }),
+    /** 権限ユニット一覧 @example [] */
+    permission_unit: zod_1.z.array(zod_1.z.unknown()).meta({ description: "権限ユニット一覧", example: [] }),
+    /** ローカル認証を持つか @example false */
+    has_local_auth: zod_1.z.boolean().meta({ description: "ローカル認証を持つか", example: false }),
+    /** 関連グループ（未使用時 null） @example null */
+    affiliated_groups: zod_1.z.unknown().nullable().meta({ description: "関連グループ", example: null }),
+});
+/** ログイン後の個人情報取得 API のレスポンス全体（user に個人情報が入る） */
+exports.AlboPersonalSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    /** ログイン結果 @example "success" */
+    login: zod_1.z.string().meta({ description: "ログイン結果", example: "success" }),
+    /** メッセージ @example "" */
+    message: zod_1.z.string().meta({ description: "メッセージ", example: "" }),
+    /** ログインメッセージ（無ければ null） @example null */
+    login_message: zod_1.z.string().nullable().meta({ description: "ログインメッセージ", example: null }),
+}), exports.AlboPersonalUserSchema);

package/dist/cjs/albo/types/alboCalendar.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlboCalendarOutlookEventSchema = exports.AlboCalendarSourceSchema = exports.AlboCalendarSourceItemSchema = void 0;
+const zod_1 = require("zod");
+const alboCommon_1 = require("./alboCommon");
+// ---------------------------------------------------------------------------
+// カレンダー（calendar）系のうち、イベント一覧（AlboCalendarSchema in ./albo）以外。
+//   - GET /api/calendar-source/            … 購読しているカレンダーソースの一覧
+//   - GET /api/calendar/outlook-event/{n}  … Outlook 連携イベント（未連携時はエラー）
+// ---------------------------------------------------------------------------
+/** カレンダーソース（学年暦・Google カレンダー連携など）1 件 */
+exports.AlboCalendarSourceItemSchema = zod_1.z.object({
+    /** カレンダーソース UUID @example "ac304d66-b0a8-11f0-afed-06347f3ce845" */
+    uuid: zod_1.z.string().meta({ description: "カレンダーソース UUID", example: "ac304d66-b0a8-11f0-afed-06347f3ce845" }),
+    /** 名称 @example "学年暦（学部）" */
+    title: zod_1.z.string().meta({ description: "名称", example: "学年暦（学部）" }),
+    /** 名称（英語。無ければ null） @example null */
+    title_en: zod_1.z.string().nullable().meta({ description: "名称（英語）", example: null }),
+    /** 購読元 URL（iCal / Google Calendar など） @example "https://calendar.google.com/calendar/ical/example/basic.ics" */
+    url: zod_1.z.string().meta({ description: "購読元 URL（iCal / Google Calendar など）", example: "https://calendar.google.com/calendar/ical/example/basic.ics" }),
+    /** 有効なソースか @example true */
+    is_living: zod_1.z.boolean().meta({ description: "有効なソースか", example: true }),
+    /** 削除済みか @example false */
+    is_deleted: zod_1.z.boolean().meta({ description: "削除済みか", example: false }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: zod_1.z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+    /** 削除日時（UNIX 秒。未削除なら null） @example null */
+    deleted_at: zod_1.z.number().nullable().meta({ description: "削除日時（UNIX 秒）", example: null }),
+    /** 作成者（無ければ null） @example "system" */
+    created_by: zod_1.z.string().nullable().meta({ description: "作成者", example: "system" }),
+    /** 更新者（無ければ null） @example null */
+    updated_by: zod_1.z.string().nullable().meta({ description: "更新者", example: null }),
+});
+/** カレンダーソース一覧取得 API のレスポンス全体 */
+exports.AlboCalendarSourceSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    /** カレンダーソースの配列 */
+    items: zod_1.z.array(exports.AlboCalendarSourceItemSchema).meta({ description: "カレンダーソースの配列" }),
+}));
+/**
+ * Outlook 連携イベント取得 API のレスポンス全体。
+ * Microsoft アカウント未連携の場合は `is_successful: false` かつ
+ * `result: { message: "No token." }` が返る。連携済みの場合はイベント配列が返る想定。
+ */
+exports.AlboCalendarOutlookEventSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    /** エラー等のメッセージ（例: "No token."） @example "No token." */
+    message: zod_1.z.string().optional().meta({ description: "エラー等のメッセージ", example: "No token." }),
+    /** イベント配列（連携済みの場合） @example [] */
+    items: zod_1.z.array(zod_1.z.unknown()).optional().meta({ description: "イベント配列（連携済みの場合）", example: [] }),
+}));

package/dist/cjs/albo/types/alboCommon.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlboActionResultSchema = exports.paginationShape = exports.alboEnvelope = void 0;
+const zod_1 = require("zod");
+/**
+ * albo（中京大学ポータル）API 共通の部品。
+ *
+ * すべての albo API は「封筒（envelope）」で包まれて返る:
+ *   { is_successful, code, api_version, gmt, user, result }
+ * エンドポイントごとに異なるのは `result` の中身だけなので、`alboEnvelope()` に
+ * result のスキーマを渡して各 API のスキーマを組み立てる。
+ * 値は API が返すキー・型のまま通す（数値の日時は基本 UNIX 秒）。
+ */
+/**
+ * 全 albo API 共通のレスポンス封筒を組み立てるヘルパー。
+ * @param resultSchema `result` の中身
+ * @param userSchema `user` の型（既定は null。auth/check-logged-in や personal では個人情報が入る）
+ */
+const alboEnvelope = (resultSchema, userSchema) => zod_1.z.object({
+    /** 処理成功フラグ @example true */
+    is_successful: zod_1.z.boolean().meta({ description: "処理成功フラグ", example: true }),
+    /** ステータスコード（HTTP 相当） @example 200 */
+    code: zod_1.z.number().meta({ description: "ステータスコード（HTTP 相当）", example: 200 }),
+    /** API バージョン @example 2 */
+    api_version: zod_1.z.number().meta({ description: "API バージョン", example: 2 }),
+    /** レスポンス生成時刻（UNIX 秒） @example 1783445975 */
+    gmt: zod_1.z.number().meta({ description: "レスポンス生成時刻（UNIX 秒）", example: 1783445975 }),
+    /** ログインユーザー情報。多くのエンドポイントでは null */
+    user: (userSchema ?? zod_1.z.unknown().nullable()),
+    /** エンドポイント固有の本体 */
+    result: resultSchema,
+});
+exports.alboEnvelope = alboEnvelope;
+/**
+ * ページング系レスポンスに共通で含まれるフィールド群。
+ * `z.object({ ...paginationShape, items: ... })` のように展開して使う。
+ */
+exports.paginationShape = {
+    /** 総ページ数 @example 3 */
+    page_total: zod_1.z.number().meta({ description: "総ページ数", example: 3 }),
+    /** 1 ページあたりの件数 @example 20 */
+    page_size: zod_1.z.number().meta({ description: "1 ページあたりの件数", example: 20 }),
+    /** 総件数 @example 57 */
+    item_count: zod_1.z.number().meta({ description: "総件数", example: 57 }),
+};
+/**
+ * ボタン操作系 API（既読化・ピン留め・いいね等）が返す汎用の結果。
+ * 例: set-read-all → `{ message: "87件のお知らせを既読にしました。", count: 87 }`
+ */
+exports.AlboActionResultSchema = (0, exports.alboEnvelope)(zod_1.z.object({
+    /** ユーザー向けの結果メッセージ（日本語） @example "1件のお知らせを既読にしました。" */
+    message: zod_1.z.string().meta({ description: "結果メッセージ（日本語）", example: "1件のお知らせを既読にしました。" }),
+    /** 操作対象の件数（件数を伴わない操作では省略） @example 1 */
+    count: zod_1.z.number().optional().meta({ description: "操作対象の件数", example: 1 }),
+}));

package/dist/cjs/albo/types/alboInformation.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlboInformationCategoryTreeSchema = exports.AlboInformationCategoryNodeSchema = exports.AlboInformationDetailSchema = exports.AlboInformationDetailResultSchema = void 0;
+const zod_1 = require("zod");
+const alboCommon_1 = require("./alboCommon");
+const albo_1 = require("./albo");
+// ---------------------------------------------------------------------------
+// お知らせ（information）系のうち、一覧（AlboInformationSchema in ./albo）以外。
+//   - GET /api/information/view/{uuid}     … お知らせ 1 件の詳細
+//   - GET /api/information-category/tree   … お知らせカテゴリのツリー
+// 既読化・ピン留め・いいね等の操作結果は AlboActionResultSchema（./alboCommon）を使う。
+// ---------------------------------------------------------------------------
+/**
+ * お知らせ詳細（GET /api/information/view/{uuid}）の本体。
+ * 一覧の 1 件（AlboInformationItemSchema）より項目が多く、本文 HTML や配信設定を含む。
+ */
+exports.AlboInformationDetailResultSchema = zod_1.z.object({
+    /** お知らせ UUID @example "12345678-90ab-cdef-1234-567890abcdef" */
+    uuid: zod_1.z.string().meta({ description: "お知らせ UUID", example: "12345678-90ab-cdef-1234-567890abcdef" }),
+    /** 発信元（部署名など） @example "グローバル交流センター" */
+    publish_from: zod_1.z.string().meta({ description: "発信元", example: "グローバル交流センター" }),
+    /** 発信元（英語。無ければ null） @example null */
+    publish_from_en: zod_1.z.string().nullable().meta({ description: "発信元（英語）", example: null }),
+    /** 発信部署（無ければ null） @example "国際課" */
+    publish_department: zod_1.z.string().nullable().meta({ description: "発信部署", example: "国際課" }),
+    /** 発信部署（英語。無ければ null） @example null */
+    publish_department_en: zod_1.z.string().nullable().meta({ description: "発信部署（英語）", example: null }),
+    /** 掲載開始日時（UNIX 秒） @example 1783445975 */
+    publish_start_at: zod_1.z.number().meta({ description: "掲載開始日時（UNIX 秒）", example: 1783445975 }),
+    /** 掲載終了日時（UNIX 秒） @example 1785000000 */
+    publish_end_at: zod_1.z.number().meta({ description: "掲載終了日時（UNIX 秒）", example: 1785000000 }),
+    /** タイトル @example "定期試験の実施について" */
+    title: zod_1.z.string().meta({ description: "タイトル", example: "定期試験の実施について" }),
+    /** タイトル（英語。無ければ null） @example null */
+    title_en: zod_1.z.string().nullable().meta({ description: "タイトル（英語）", example: null }),
+    /** 本文（HTML 文字列） @example "<p>本文...</p>" */
+    content: zod_1.z.string().meta({ description: "本文（HTML 文字列）", example: "<p>本文...</p>" }),
+    /** 本文（英語。無ければ null） @example null */
+    content_en: zod_1.z.string().nullable().meta({ description: "本文（英語）", example: null }),
+    /** 優先度 @example 0 */
+    priority: zod_1.z.number().meta({ description: "優先度", example: 0 }),
+    /** イベント名（無ければ null） @example null */
+    event_title: zod_1.z.string().nullable().meta({ description: "イベント名", example: null }),
+    /** イベント名（英語。無ければ null） @example null */
+    event_title_en: zod_1.z.string().nullable().meta({ description: "イベント名（英語）", example: null }),
+    /** イベント開始日時（UNIX 秒。無ければ null） @example null */
+    event_start_at: zod_1.z.number().nullable().meta({ description: "イベント開始日時（UNIX 秒）", example: null }),
+    /** イベント終了日時（UNIX 秒。無ければ null） @example null */
+    event_end_at: zod_1.z.number().nullable().meta({ description: "イベント終了日時（UNIX 秒）", example: null }),
+    /** 開封確認を要求するか（未設定時 null） @example null */
+    is_read_receipt: zod_1.z.unknown().nullable().meta({ description: "開封確認を要求するか", example: null }),
+    /** 再送が必要か（未設定時 null） @example null */
+    is_need_resend: zod_1.z.unknown().nullable().meta({ description: "再送が必要か", example: null }),
+    /** アプリ通知を送るか @example false */
+    is_send_notification: zod_1.z.boolean().meta({ description: "アプリ通知を送るか", example: false }),
+    /** メール通知を送るか（0/1 の数値フラグ） @example 0 */
+    is_send_mail_notification: zod_1.z.number().meta({ description: "メール通知を送るか（0/1）", example: 0 }),
+    /** 有効フラグ @example true */
+    is_active: zod_1.z.boolean().meta({ description: "有効フラグ", example: true }),
+    /** 通知メールの差出人（無ければ null） @example null */
+    mail_from: zod_1.z.string().nullable().meta({ description: "通知メールの差出人", example: null }),
+    /** 任意オプション（未使用時 null） */
+    options: zod_1.z.unknown().nullable().meta({ description: "任意オプション" }),
+    /** 作成者（無ければ null） @example "kyomu" */
+    created_by: zod_1.z.string().nullable().meta({ description: "作成者", example: "kyomu" }),
+    /** 更新者（無ければ null） @example null */
+    updated_by: zod_1.z.string().nullable().meta({ description: "更新者", example: null }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: zod_1.z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: zod_1.z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+    /** テンプレートか（0/1 の数値フラグ） @example 0 */
+    is_template: zod_1.z.number().meta({ description: "テンプレートか（0/1）", example: 0 }),
+    /** 公開中か @example true */
+    is_public: zod_1.z.boolean().meta({ description: "公開中か", example: true }),
+    /** イベント情報を持つか @example false */
+    has_event: zod_1.z.boolean().meta({ description: "イベント情報を持つか", example: false }),
+    /** 既読か @example false */
+    is_read: zod_1.z.boolean().meta({ description: "既読か", example: false }),
+    /** ピン留めされているか @example false */
+    is_pinned: zod_1.z.boolean().meta({ description: "ピン留めされているか", example: false }),
+    /** 「いいね」済みか @example false */
+    is_reacted_good: zod_1.z.boolean().meta({ description: "「いいね」済みか", example: false }),
+    /** 「いいね」数 @example 0 */
+    good_count: zod_1.z.number().meta({ description: "「いいね」数", example: 0 }),
+    /** 掲載状態（例: "public"） @example "public" */
+    status_period: zod_1.z.string().meta({ description: "掲載状態", example: "public" }),
+    /** カテゴリ */
+    category: albo_1.AlboInformationCategorySchema,
+    /** 権限 UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    permission_uuid: zod_1.z.string().meta({ description: "権限 UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** 配信対象 UUID @example "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" */
+    target_uuid: zod_1.z.string().meta({ description: "配信対象 UUID", example: "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" }),
+    /** 授業時間割との紐付け（無ければ null） @example null */
+    class_timetable: zod_1.z.unknown().nullable().meta({ description: "授業時間割との紐付け", example: null }),
+    /** 添付ファイル（無ければ null） @example null */
+    files: zod_1.z.array(albo_1.AlboInformationFileSchema).nullable().meta({ description: "添付ファイル", example: null }),
+    /** 個人向け添付ファイル（無ければ null） @example null */
+    personal_files: zod_1.z.array(albo_1.AlboInformationFileSchema).nullable().meta({ description: "個人向け添付ファイル", example: null }),
+    /** 本文中の画像（無ければ null） @example null */
+    images: zod_1.z.array(albo_1.AlboInformationFileSchema).nullable().meta({ description: "本文中の画像", example: null }),
+    /** ハッシュタグ @example [] */
+    hashtags: zod_1.z.array(zod_1.z.unknown()).meta({ description: "ハッシュタグ", example: [] }),
+    /** Google カレンダー連携リンク（イベントが無ければ ""） @example "" */
+    event_gcal_link: zod_1.z.string().meta({ description: "Google カレンダー連携リンク", example: "" }),
+    /** Google カレンダー連携リンク（英語。無ければ ""） @example "" */
+    event_gcal_link_en: zod_1.z.string().meta({ description: "Google カレンダー連携リンク（英語）", example: "" }),
+});
+/** お知らせ詳細取得 API のレスポンス全体 */
+exports.AlboInformationDetailSchema = (0, alboCommon_1.alboEnvelope)(exports.AlboInformationDetailResultSchema);
+/** お知らせカテゴリツリーの 1 ノード。`children` に同型ノードがぶら下がる再帰構造 */
+exports.AlboInformationCategoryNodeSchema = zod_1.z.lazy(() => zod_1.z.object({
+    /** カテゴリ UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    uuid: zod_1.z.string().meta({ description: "カテゴリ UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** カテゴリ名（例: "教務"） @example "教務" */
+    name: zod_1.z.string().meta({ description: "カテゴリ名", example: "教務" }),
+    /** カテゴリ名（英語。無ければ null） @example null */
+    name_en: zod_1.z.string().nullable().meta({ description: "カテゴリ名（英語）", example: null }),
+    /** 説明（無ければ null） @example null */
+    description: zod_1.z.string().nullable().meta({ description: "説明", example: null }),
+    /** 説明（英語。無ければ null） @example null */
+    description_en: zod_1.z.string().nullable().meta({ description: "説明（英語）", example: null }),
+    /** 表示順 @example 0 */
+    order: zod_1.z.number().meta({ description: "表示順", example: 0 }),
+    /** ゲスト向けに公開するか（0/1 の数値フラグ） @example 0 */
+    is_for_guest: zod_1.z.number().meta({ description: "ゲスト向けに公開するか（0/1）", example: 0 }),
+    /** 子カテゴリ（無ければ空配列） */
+    children: zod_1.z.array(exports.AlboInformationCategoryNodeSchema).meta({ description: "子カテゴリ", example: [] }),
+    /** このカテゴリ配下の未読お知らせ数 @example 0 */
+    unread_count: zod_1.z.number().meta({ description: "このカテゴリ配下の未読お知らせ数", example: 0 }),
+}));
+/** お知らせカテゴリツリー取得 API のレスポンス全体 */
+exports.AlboInformationCategoryTreeSchema = (0, alboCommon_1.alboEnvelope)(zod_1.z.object({
+    /** カテゴリツリーの最上位ノード配列 */
+    items: zod_1.z.array(exports.AlboInformationCategoryNodeSchema).meta({ description: "カテゴリツリーの最上位ノード配列" }),
+}));