chukyo-sdk 0.1.0

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

@@ -0,0 +1,214 @@
+import { z } from "zod";
+/**
+ * お知らせ詳細（GET /api/information/view/{uuid}）の本体。
+ * 一覧の 1 件（AlboInformationItemSchema）より項目が多く、本文 HTML や配信設定を含む。
+ */
+export declare const AlboInformationDetailResultSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    publish_from: z.ZodString;
+    publish_from_en: z.ZodNullable<z.ZodString>;
+    publish_department: z.ZodNullable<z.ZodString>;
+    publish_department_en: z.ZodNullable<z.ZodString>;
+    publish_start_at: z.ZodNumber;
+    publish_end_at: z.ZodNumber;
+    title: z.ZodString;
+    title_en: z.ZodNullable<z.ZodString>;
+    content: z.ZodString;
+    content_en: z.ZodNullable<z.ZodString>;
+    priority: z.ZodNumber;
+    event_title: z.ZodNullable<z.ZodString>;
+    event_title_en: z.ZodNullable<z.ZodString>;
+    event_start_at: z.ZodNullable<z.ZodNumber>;
+    event_end_at: z.ZodNullable<z.ZodNumber>;
+    is_read_receipt: z.ZodNullable<z.ZodUnknown>;
+    is_need_resend: z.ZodNullable<z.ZodUnknown>;
+    is_send_notification: z.ZodBoolean;
+    is_send_mail_notification: z.ZodNumber;
+    is_active: z.ZodBoolean;
+    mail_from: z.ZodNullable<z.ZodString>;
+    options: z.ZodNullable<z.ZodUnknown>;
+    created_by: z.ZodNullable<z.ZodString>;
+    updated_by: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+    is_template: z.ZodNumber;
+    is_public: z.ZodBoolean;
+    has_event: z.ZodBoolean;
+    is_read: z.ZodBoolean;
+    is_pinned: z.ZodBoolean;
+    is_reacted_good: z.ZodBoolean;
+    good_count: z.ZodNumber;
+    status_period: z.ZodString;
+    category: z.ZodObject<{
+        uuid: z.ZodString;
+        name: z.ZodString;
+        name_en: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        description_en: z.ZodNullable<z.ZodString>;
+        order: z.ZodNumber;
+        is_for_guest: z.ZodBoolean;
+        created_by: z.ZodString;
+        updated_by: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$strip>;
+    permission_uuid: z.ZodString;
+    target_uuid: z.ZodString;
+    class_timetable: z.ZodNullable<z.ZodUnknown>;
+    files: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        file_name: z.ZodString;
+        mime_type: z.ZodString;
+        is_thumb_exists: z.ZodBoolean;
+        created_by: z.ZodString;
+        created_at: z.ZodNumber;
+    }, z.core.$strip>>>;
+    personal_files: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        file_name: z.ZodString;
+        mime_type: z.ZodString;
+        is_thumb_exists: z.ZodBoolean;
+        created_by: z.ZodString;
+        created_at: z.ZodNumber;
+    }, z.core.$strip>>>;
+    images: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        file_name: z.ZodString;
+        mime_type: z.ZodString;
+        is_thumb_exists: z.ZodBoolean;
+        created_by: z.ZodString;
+        created_at: z.ZodNumber;
+    }, z.core.$strip>>>;
+    hashtags: z.ZodArray<z.ZodUnknown>;
+    event_gcal_link: z.ZodString;
+    event_gcal_link_en: z.ZodString;
+}, z.core.$strip>;
+export type AlboInformationDetailResultDTO = z.infer<typeof AlboInformationDetailResultSchema>;
+/** お知らせ詳細取得 API のレスポンス全体 */
+export declare const AlboInformationDetailSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        uuid: z.ZodString;
+        publish_from: z.ZodString;
+        publish_from_en: z.ZodNullable<z.ZodString>;
+        publish_department: z.ZodNullable<z.ZodString>;
+        publish_department_en: z.ZodNullable<z.ZodString>;
+        publish_start_at: z.ZodNumber;
+        publish_end_at: z.ZodNumber;
+        title: z.ZodString;
+        title_en: z.ZodNullable<z.ZodString>;
+        content: z.ZodString;
+        content_en: z.ZodNullable<z.ZodString>;
+        priority: z.ZodNumber;
+        event_title: z.ZodNullable<z.ZodString>;
+        event_title_en: z.ZodNullable<z.ZodString>;
+        event_start_at: z.ZodNullable<z.ZodNumber>;
+        event_end_at: z.ZodNullable<z.ZodNumber>;
+        is_read_receipt: z.ZodNullable<z.ZodUnknown>;
+        is_need_resend: z.ZodNullable<z.ZodUnknown>;
+        is_send_notification: z.ZodBoolean;
+        is_send_mail_notification: z.ZodNumber;
+        is_active: z.ZodBoolean;
+        mail_from: z.ZodNullable<z.ZodString>;
+        options: z.ZodNullable<z.ZodUnknown>;
+        created_by: z.ZodNullable<z.ZodString>;
+        updated_by: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        is_template: z.ZodNumber;
+        is_public: z.ZodBoolean;
+        has_event: z.ZodBoolean;
+        is_read: z.ZodBoolean;
+        is_pinned: z.ZodBoolean;
+        is_reacted_good: z.ZodBoolean;
+        good_count: z.ZodNumber;
+        status_period: z.ZodString;
+        category: z.ZodObject<{
+            uuid: z.ZodString;
+            name: z.ZodString;
+            name_en: z.ZodNullable<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            description_en: z.ZodNullable<z.ZodString>;
+            order: z.ZodNumber;
+            is_for_guest: z.ZodBoolean;
+            created_by: z.ZodString;
+            updated_by: z.ZodNullable<z.ZodString>;
+            created_at: z.ZodNumber;
+            updated_at: z.ZodNumber;
+        }, z.core.$strip>;
+        permission_uuid: z.ZodString;
+        target_uuid: z.ZodString;
+        class_timetable: z.ZodNullable<z.ZodUnknown>;
+        files: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            file_name: z.ZodString;
+            mime_type: z.ZodString;
+            is_thumb_exists: z.ZodBoolean;
+            created_by: z.ZodString;
+            created_at: z.ZodNumber;
+        }, z.core.$strip>>>;
+        personal_files: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            file_name: z.ZodString;
+            mime_type: z.ZodString;
+            is_thumb_exists: z.ZodBoolean;
+            created_by: z.ZodString;
+            created_at: z.ZodNumber;
+        }, z.core.$strip>>>;
+        images: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            file_name: z.ZodString;
+            mime_type: z.ZodString;
+            is_thumb_exists: z.ZodBoolean;
+            created_by: z.ZodString;
+            created_at: z.ZodNumber;
+        }, z.core.$strip>>>;
+        hashtags: z.ZodArray<z.ZodUnknown>;
+        event_gcal_link: z.ZodString;
+        event_gcal_link_en: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboInformationDetailDTO = z.infer<typeof AlboInformationDetailSchema>;
+/**
+ * お知らせカテゴリツリーの 1 ノード（GET /api/information-category/tree）。
+ * `children` に同型のノードがぶら下がる再帰構造。
+ */
+export interface AlboInformationCategoryNodeDTO {
+    /** カテゴリ UUID */
+    uuid: string;
+    /** カテゴリ名（例: "教務"） */
+    name: string;
+    /** カテゴリ名（英語。無ければ null） */
+    name_en: string | null;
+    /** 説明（無ければ null） */
+    description: string | null;
+    /** 説明（英語。無ければ null） */
+    description_en: string | null;
+    /** 表示順 */
+    order: number;
+    /** ゲスト向けに公開するか（0/1 の数値フラグ） */
+    is_for_guest: number;
+    /** 子カテゴリ（無ければ空配列） */
+    children: AlboInformationCategoryNodeDTO[];
+    /** このカテゴリ配下の未読お知らせ数 */
+    unread_count: number;
+}
+/** お知らせカテゴリツリーの 1 ノード。`children` に同型ノードがぶら下がる再帰構造 */
+export declare const AlboInformationCategoryNodeSchema: z.ZodType<AlboInformationCategoryNodeDTO>;
+/** お知らせカテゴリツリー取得 API のレスポンス全体 */
+export declare const AlboInformationCategoryTreeSchema: 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.ZodType<AlboInformationCategoryNodeDTO, unknown, z.core.$ZodTypeInternals<AlboInformationCategoryNodeDTO, unknown>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboInformationCategoryTreeDTO = z.infer<typeof AlboInformationCategoryTreeSchema>;
+//# sourceMappingURL=alboInformation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alboInformation.d.ts","sourceRoot":"","sources":["../../../../src/albo/types/alboInformation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2F5C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE/F,4BAA4B;AAC5B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAkD,CAAC;AAE3F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC3C,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uBAAuB;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,EAAE,8BAA8B,EAAE,CAAC;IAC3C,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,qDAAqD;AACrD,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAqBvF,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,iCAAiC;;;;;;;;;iBAK7C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

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

@@ -0,0 +1,133 @@
+import { z } from "zod";
+import { alboEnvelope } from "./alboCommon";
+import { AlboInformationCategorySchema, AlboInformationFileSchema } from "./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 や配信設定を含む。
+ */
+export const AlboInformationDetailResultSchema = 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 "国際課" */
+    publish_department: z.string().nullable().meta({ description: "発信部署", example: "国際課" }),
+    /** 発信部署（英語。無ければ 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 }),
+    /** 開封確認を要求するか（未設定時 null） @example null */
+    is_read_receipt: z.unknown().nullable().meta({ description: "開封確認を要求するか", example: null }),
+    /** 再送が必要か（未設定時 null） @example null */
+    is_need_resend: z.unknown().nullable().meta({ description: "再送が必要か", example: null }),
+    /** アプリ通知を送るか @example false */
+    is_send_notification: z.boolean().meta({ description: "アプリ通知を送るか", example: false }),
+    /** メール通知を送るか（0/1 の数値フラグ） @example 0 */
+    is_send_mail_notification: z.number().meta({ description: "メール通知を送るか（0/1）", example: 0 }),
+    /** 有効フラグ @example true */
+    is_active: z.boolean().meta({ description: "有効フラグ", example: true }),
+    /** 通知メールの差出人（無ければ null） @example null */
+    mail_from: z.string().nullable().meta({ description: "通知メールの差出人", example: null }),
+    /** 任意オプション（未使用時 null） */
+    options: z.unknown().nullable().meta({ description: "任意オプション" }),
+    /** 作成者（無ければ null） @example "kyomu" */
+    created_by: z.string().nullable().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 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_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 */
+    has_event: z.boolean().meta({ description: "イベント情報を持つか", example: false }),
+    /** 既読か @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 }),
+    /** 掲載状態（例: "public"） @example "public" */
+    status_period: z.string().meta({ description: "掲載状態", example: "public" }),
+    /** カテゴリ */
+    category: AlboInformationCategorySchema,
+    /** 権限 UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    permission_uuid: z.string().meta({ description: "権限 UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** 配信対象 UUID @example "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" */
+    target_uuid: z.string().meta({ description: "配信対象 UUID", example: "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" }),
+    /** 授業時間割との紐付け（無ければ null） @example null */
+    class_timetable: z.unknown().nullable().meta({ description: "授業時間割との紐付け", example: null }),
+    /** 添付ファイル（無ければ 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 }),
+    /** ハッシュタグ @example [] */
+    hashtags: z.array(z.unknown()).meta({ description: "ハッシュタグ", example: [] }),
+    /** Google カレンダー連携リンク（イベントが無ければ ""） @example "" */
+    event_gcal_link: z.string().meta({ description: "Google カレンダー連携リンク", example: "" }),
+    /** Google カレンダー連携リンク（英語。無ければ ""） @example "" */
+    event_gcal_link_en: z.string().meta({ description: "Google カレンダー連携リンク（英語）", example: "" }),
+});
+/** お知らせ詳細取得 API のレスポンス全体 */
+export const AlboInformationDetailSchema = alboEnvelope(AlboInformationDetailResultSchema);
+/** お知らせカテゴリツリーの 1 ノード。`children` に同型ノードがぶら下がる再帰構造 */
+export const AlboInformationCategoryNodeSchema = z.lazy(() => 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 }),
+    /** ゲスト向けに公開するか（0/1 の数値フラグ） @example 0 */
+    is_for_guest: z.number().meta({ description: "ゲスト向けに公開するか（0/1）", example: 0 }),
+    /** 子カテゴリ（無ければ空配列） */
+    children: z.array(AlboInformationCategoryNodeSchema).meta({ description: "子カテゴリ", example: [] }),
+    /** このカテゴリ配下の未読お知らせ数 @example 0 */
+    unread_count: z.number().meta({ description: "このカテゴリ配下の未読お知らせ数", example: 0 }),
+}));
+/** お知らせカテゴリツリー取得 API のレスポンス全体 */
+export const AlboInformationCategoryTreeSchema = alboEnvelope(z.object({
+    /** カテゴリツリーの最上位ノード配列 */
+    items: z.array(AlboInformationCategoryNodeSchema).meta({ description: "カテゴリツリーの最上位ノード配列" }),
+}));

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

@@ -0,0 +1,114 @@
+import { z } from "zod";
+/** メニュー（タブ）1 件 */
+export declare const AlboMenuItemSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    name: z.ZodString;
+    name_en: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    description_en: z.ZodNullable<z.ZodString>;
+    order: z.ZodNumber;
+    start_at: z.ZodNumber;
+    end_at: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+    target_uuid: z.ZodString;
+}, z.core.$strip>;
+export type AlboMenuItemDTO = z.infer<typeof AlboMenuItemSchema>;
+/** メニュー一覧取得 API のレスポンス全体 */
+export declare const AlboMenuSchema: 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;
+            name: z.ZodString;
+            name_en: z.ZodNullable<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            description_en: z.ZodNullable<z.ZodString>;
+            order: z.ZodNumber;
+            start_at: z.ZodNumber;
+            end_at: z.ZodNumber;
+            created_at: z.ZodNumber;
+            updated_at: z.ZodNumber;
+            target_uuid: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboMenuDTO = z.infer<typeof AlboMenuSchema>;
+/**
+ * メニューに配置される 1 モジュール（お知らせ・学年暦・アンケート等のウィジェット）。
+ * `parts` はモジュール種別（type）ごとに構造が大きく異なるため無変換で保持する。
+ */
+export declare const AlboMenuModuleSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    type: z.ZodNumber;
+    name: z.ZodString;
+    name_en: z.ZodNullable<z.ZodString>;
+    description: z.ZodString;
+    description_en: z.ZodNullable<z.ZodString>;
+    order: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+    target_uuid: z.ZodString;
+    parts: z.ZodUnknown;
+}, z.core.$strip>;
+export type AlboMenuModuleDTO = z.infer<typeof AlboMenuModuleSchema>;
+/** メニュー詳細取得 API のレスポンス全体 */
+export declare const AlboMenuDetailSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        uuid: z.ZodString;
+        name: z.ZodString;
+        name_en: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        description_en: z.ZodNullable<z.ZodString>;
+        order: z.ZodNumber;
+        start_at: z.ZodNumber;
+        end_at: z.ZodNumber;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        target_uuid: z.ZodString;
+        modules: z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            type: z.ZodNumber;
+            name: z.ZodString;
+            name_en: z.ZodNullable<z.ZodString>;
+            description: z.ZodString;
+            description_en: z.ZodNullable<z.ZodString>;
+            order: z.ZodNumber;
+            created_at: z.ZodNumber;
+            updated_at: z.ZodNumber;
+            target_uuid: z.ZodString;
+            parts: z.ZodUnknown;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboMenuDetailDTO = z.infer<typeof AlboMenuDetailSchema>;
+/**
+ * メニューレイアウト取得 API のレスポンス全体。
+ * `layout` と `calendar_display_setting` は JSON を文字列化した値がそのまま入っている
+ * （必要ならさらに JSON.parse する）。保存 API（menu-layout/save）も同じ形で返る。
+ */
+export declare const AlboMenuLayoutSchema: z.ZodObject<{
+    is_successful: z.ZodBoolean;
+    code: z.ZodNumber;
+    api_version: z.ZodNumber;
+    gmt: z.ZodNumber;
+    user: z.ZodNullable<z.ZodUnknown>;
+    result: z.ZodObject<{
+        menu_uuid: z.ZodString;
+        layout: z.ZodString;
+        calendar_display_setting: z.ZodString;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AlboMenuLayoutDTO = z.infer<typeof AlboMenuLayoutSchema>;
+//# sourceMappingURL=alboMenu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alboMenu.d.ts","sourceRoot":"","sources":["../../../../src/albo/types/alboMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,kBAAkB;AAClB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAuB7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,4BAA4B;AAC5B,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAK1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAuB/B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE,4BAA4B;AAC5B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAahC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { alboEnvelope } from "./alboCommon";
+// ---------------------------------------------------------------------------
+// メニュー（menu）系。ポータルのタブ／ページとその配置。
+//   - GET  /api/menu                     … メニュー（タブ）一覧
+//   - GET  /api/menu/view/{uuid}         … メニュー詳細（配置モジュールを含む）
+//   - GET  /api/menu-layout/view/{uuid}  … メニューのレイアウト設定
+//   - POST /api/menu-layout/save/{uuid}  … レイアウト保存（レスポンスは view と同型）
+// ---------------------------------------------------------------------------
+/** メニュー（タブ）1 件 */
+export const AlboMenuItemSchema = 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 }),
+    /** 公開開始日時（UNIX 秒） @example 1680000000 */
+    start_at: z.number().meta({ description: "公開開始日時（UNIX 秒）", example: 1680000000 }),
+    /** 公開終了日時（UNIX 秒。実質無期限の場合 253402268400 等） @example 253402268400 */
+    end_at: z.number().meta({ description: "公開終了日時（UNIX 秒）", example: 253402268400 }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+    /** 配信対象 UUID @example "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" */
+    target_uuid: z.string().meta({ description: "配信対象 UUID", example: "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" }),
+});
+/** メニュー一覧取得 API のレスポンス全体 */
+export const AlboMenuSchema = alboEnvelope(z.object({
+    /** メニュー配列 */
+    items: z.array(AlboMenuItemSchema).meta({ description: "メニュー配列" }),
+}));
+/**
+ * メニューに配置される 1 モジュール（お知らせ・学年暦・アンケート等のウィジェット）。
+ * `parts` はモジュール種別（type）ごとに構造が大きく異なるため無変換で保持する。
+ */
+export const AlboMenuModuleSchema = z.object({
+    /** モジュール UUID @example "cccccccc-dddd-eeee-ffff-000000000000" */
+    uuid: z.string().meta({ description: "モジュール UUID", example: "cccccccc-dddd-eeee-ffff-000000000000" }),
+    /** モジュール種別（1=学内システム, 2=お知らせ, 3=アンケート, 4=学年暦, 8=汎用申請 …） @example 2 */
+    type: z.number().meta({ description: "モジュール種別（数値コード）", example: 2 }),
+    /** モジュール名（例: "お知らせ"） @example "お知らせ" */
+    name: z.string().meta({ description: "モジュール名", example: "お知らせ" }),
+    /** モジュール名（英語。無ければ null） @example null */
+    name_en: z.string().nullable().meta({ description: "モジュール名（英語）", example: null }),
+    /** 説明 @example "" */
+    description: z.string().meta({ description: "説明", example: "" }),
+    /** 説明（英語。無ければ null） @example null */
+    description_en: z.string().nullable().meta({ description: "説明（英語）", example: null }),
+    /** 表示順 @example 0 */
+    order: z.number().meta({ description: "表示順", 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 }),
+    /** 配信対象 UUID @example "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" */
+    target_uuid: z.string().meta({ description: "配信対象 UUID", example: "bbbbbbbb-cccc-dddd-eeee-ffffffffffff" }),
+    /** モジュール固有の設定。種別ごとに形が異なるため無変換で保持する */
+    parts: z.unknown().meta({ description: "モジュール固有の設定（種別ごとに形が異なるため無変換で保持）" }),
+});
+/** メニュー詳細取得 API のレスポンス全体 */
+export const AlboMenuDetailSchema = alboEnvelope(AlboMenuItemSchema.extend({
+    /** 配置モジュールの配列 */
+    modules: z.array(AlboMenuModuleSchema).meta({ description: "配置モジュールの配列" }),
+}));
+/**
+ * メニューレイアウト取得 API のレスポンス全体。
+ * `layout` と `calendar_display_setting` は JSON を文字列化した値がそのまま入っている
+ * （必要ならさらに JSON.parse する）。保存 API（menu-layout/save）も同じ形で返る。
+ */
+export const AlboMenuLayoutSchema = alboEnvelope(z.object({
+    /** 対象メニューの UUID @example "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" */
+    menu_uuid: z.string().meta({ description: "対象メニューの UUID", example: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }),
+    /** グリッド配置（JSON 文字列） @example "[{\"w\":1,\"h\":33,\"x\":1,\"y\":35,\"i\":\"widget-1\",\"minH\":15}]" */
+    layout: z.string().meta({ description: "グリッド配置（JSON 文字列）", example: '[{"w":1,"h":33,"x":1,"y":35,"i":"widget-1","minH":15}]' }),
+    /** カレンダー表示設定（JSON 文字列） @example "{}" */
+    calendar_display_setting: z.string().meta({ description: "カレンダー表示設定（JSON 文字列）", example: "{}" }),
+    /** 作成日時（UNIX 秒） @example 1700000000 */
+    created_at: z.number().meta({ description: "作成日時（UNIX 秒）", example: 1700000000 }),
+    /** 更新日時（UNIX 秒） @example 1700000000 */
+    updated_at: z.number().meta({ description: "更新日時（UNIX 秒）", example: 1700000000 }),
+}));