chukyo-sdk 0.1.0

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

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

package/dist/esm/albo/types/alboCalendar.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+/** カレンダーソース（学年暦・Google カレンダー連携など）1 件 */
+export declare const AlboCalendarSourceItemSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    title: z.ZodString;
+    title_en: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    is_living: z.ZodBoolean;
+    is_deleted: z.ZodBoolean;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+    deleted_at: z.ZodNullable<z.ZodNumber>;
+    created_by: z.ZodNullable<z.ZodString>;
+    updated_by: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AlboCalendarSourceItemDTO = z.infer<typeof AlboCalendarSourceItemSchema>;
+/** カレンダーソース一覧取得 API のレスポンス全体 */
+export declare const AlboCalendarSourceSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            title: z.ZodString;
+            title_en: z.ZodNullable<z.ZodString>;
+            url: z.ZodString;
+            is_living: z.ZodBoolean;
+            is_deleted: z.ZodBoolean;
+            created_at: z.ZodNumber;
+            updated_at: z.ZodNumber;
+            deleted_at: z.ZodNullable<z.ZodNumber>;
+            created_by: z.ZodNullable<z.ZodString>;
+            updated_by: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboCalendarSourceDTO = z.infer<typeof AlboCalendarSourceSchema>;
+/**
+ * Outlook 連携イベント取得 API のレスポンス全体。
+ * Microsoft アカウント未連携の場合は `is_successful: false` かつ
+ * `result: { message: "No token." }` が返る。連携済みの場合はイベント配列が返る想定。
+ */
+export declare const AlboCalendarOutlookEventSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        message: z.ZodOptional<z.ZodString>;
+        items: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboCalendarOutlookEventDTO = z.infer<typeof AlboCalendarOutlookEventSchema>;
+//# sourceMappingURL=alboCalendar.d.ts.map

package/dist/esm/albo/types/alboCalendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alboCalendar.d.ts","sourceRoot":"","sources":["../../../../src/albo/types/alboCalendar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,wCAAwC;AACxC,eAAO,MAAM,4BAA4B;;;;;;;;;;;;iBAuBvC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErF,gCAAgC;AAChC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;iBAKpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;iBAO1C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

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

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

package/dist/esm/albo/types/alboCommon.d.ts

@@ -0,0 +1,52 @@
+import { z } from "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 では個人情報が入る）
+ */
+export declare const alboEnvelope: <R extends z.ZodTypeAny, U extends z.ZodTypeAny = z.ZodNullable<z.ZodUnknown>>(resultSchema: R, userSchema?: U) => z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: U;
+    result: R;
+}, z.core.$strip>;
+/**
+ * ページング系レスポンスに共通で含まれるフィールド群。
+ * `z.object({ ...paginationShape, items: ... })` のように展開して使う。
+ */
+export declare const paginationShape: {
+    /** 総ページ数 @example 3 */
+    readonly page_total: z.ZodNumber;
+    /** 1 ページあたりの件数 @example 20 */
+    readonly page_size: z.ZodNumber;
+    /** 総件数 @example 57 */
+    readonly item_count: z.ZodNumber;
+};
+/**
+ * ボタン操作系 API（既読化・ピン留め・いいね等）が返す汎用の結果。
+ * 例: set-read-all → `{ message: "87件のお知らせを既読にしました。", count: 87 }`
+ */
+export declare const AlboActionResultSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        message: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboActionResultDTO = z.infer<typeof AlboActionResultSchema>;
+//# sourceMappingURL=alboCommon.d.ts.map

package/dist/esm/albo/types/alboCommon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alboCommon.d.ts","sourceRoot":"","sources":["../../../../src/albo/types/alboCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,EACrG,cAAc,CAAC,EACf,aAAa,CAAC;;;;;UAYsC,CAAC;;iBAGnD,CAAC;AAEP;;;GAGG;AACH,eAAO,MAAM,eAAe;IACxB,uBAAuB;;IAEvB,8BAA8B;;IAE9B,sBAAsB;;CAEhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAOlC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

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

@@ -0,0 +1,51 @@
+import { z } from "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 では個人情報が入る）
+ */
+export const alboEnvelope = (resultSchema, userSchema) => z.object({
+    /** 処理成功フラグ @example true */
+    is_successful: z.boolean().meta({ description: "処理成功フラグ", example: true }),
+    /** ステータスコード（HTTP 相当） @example 200 */
+    code: z.number().meta({ description: "ステータスコード（HTTP 相当）", example: 200 }),
+    /** API バージョン @example 2 */
+    api_version: z.number().meta({ description: "API バージョン", example: 2 }),
+    /** レスポンス生成時刻（UNIX 秒） @example 1783445975 */
+    gmt: z.number().meta({ description: "レスポンス生成時刻（UNIX 秒）", example: 1783445975 }),
+    /** ログインユーザー情報。多くのエンドポイントでは null */
+    user: (userSchema ?? z.unknown().nullable()),
+    /** エンドポイント固有の本体 */
+    result: resultSchema,
+});
+/**
+ * ページング系レスポンスに共通で含まれるフィールド群。
+ * `z.object({ ...paginationShape, items: ... })` のように展開して使う。
+ */
+export const paginationShape = {
+    /** 総ページ数 @example 3 */
+    page_total: z.number().meta({ description: "総ページ数", example: 3 }),
+    /** 1 ページあたりの件数 @example 20 */
+    page_size: z.number().meta({ description: "1 ページあたりの件数", example: 20 }),
+    /** 総件数 @example 57 */
+    item_count: z.number().meta({ description: "総件数", example: 57 }),
+};
+/**
+ * ボタン操作系 API（既読化・ピン留め・いいね等）が返す汎用の結果。
+ * 例: set-read-all → `{ message: "87件のお知らせを既読にしました。", count: 87 }`
+ */
+export const AlboActionResultSchema = alboEnvelope(z.object({
+    /** ユーザー向けの結果メッセージ（日本語） @example "1件のお知らせを既読にしました。" */
+    message: z.string().meta({ description: "結果メッセージ（日本語）", example: "1件のお知らせを既読にしました。" }),
+    /** 操作対象の件数（件数を伴わない操作では省略） @example 1 */
+    count: z.number().optional().meta({ description: "操作対象の件数", example: 1 }),
+}));