lansenger-cli 1.0.0 → 1.0.2

package/dist/commands/calendar.js

@@ -3,33 +3,61 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCalendarCommands = registerCalendarCommands;
 const utils_1 = require("../utils");
 function registerCalendarCommands(program) {
-    const cmd = program.command("calendar").description("Manage calendars and schedules");
+    const cmd = program.command("calendar").description("Calendar and schedule operations");
     cmd
         .command("primary")
         .description("Fetch primary calendar")
-        .option("--user-token <token>", "User token")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
         .action(async (opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchPrimaryCalendar({ user_token: opts.userToken || undefined });
+        const result = await client.fetchPrimaryCalendar({
+            user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
+        });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
     });
     cmd
         .command("create-schedule")
         .description("Create a schedule/event")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--summary <summary>", "Schedule summary/title")
-        .requiredOption("--start-time <json>", "Start time JSON")
-        .requiredOption("--end-time <json>", "End time JSON")
-        .requiredOption("--attendees <json>", "Attendees JSON array")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<summary>", "Schedule summary/title")
+        .argument("<startTime>", "Start time (unix timestamp in seconds)")
+        .argument("<endTime>", "End time (unix timestamp in seconds)")
+        .argument("<attendees>", "Attendees as JSON list: '[{\"staffId\":\"xxx\",\"attendeeFlag\":\"yes\"}]'")
+        .option("-d, --desc <desc>", "Schedule description", "")
+        .option("--all-day <allDay>", "yes or no", "no")
+        .option("--date <date>", "Date string for allDay=yes, e.g. 2026-01-01", "")
+        .option("--repeat <repeat>", "Repeat type: no, daily, weekly, monthly, yearly, work_day, custom", "no")
+        .option("--reminder <reminder>", "Reminder type: yes or no", "yes")
+        .option("--tz <tz>", "Time zone, e.g. Asia/Shanghai", "Asia/Shanghai")
+        .option("--rule <rule>", "Repeat rule (RFC 5545 JSON)", "")
+        .option("--expire <expire>", "Expire date type: yes or no", "")
+        .option("--attendee-perms <perms>", "Attendee permissions: can_modify/can_invite/can_see/none", "")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, summary, startTime, endTime, attendees, opts) => {
         const client = (0, utils_1.getClient)();
-        const startTime = (0, utils_1.parseJsonOption)(opts.startTime);
-        const endTime = (0, utils_1.parseJsonOption)(opts.endTime);
-        const attendees = (0, utils_1.parseJsonOption)(opts.attendees);
-        const result = await client.createSchedule(opts.calendarId, opts.summary, startTime, endTime, attendees, {
+        const attendeesList = (0, utils_1.parseJsonOption)(attendees);
+        const startTimeInt = parseInt(startTime);
+        const endTimeInt = parseInt(endTime);
+        const startTimeDict = { time: startTimeInt, date: opts.date, timeZone: opts.tz };
+        const endTimeDict = { time: endTimeInt, date: opts.date, timeZone: opts.tz };
+        if (opts.allDay === "yes") {
+            startTimeDict.timeZone = "UTC";
+            endTimeDict.timeZone = "UTC";
+        }
+        const result = await client.createSchedule(calendarId, summary, startTimeDict, endTimeDict, attendeesList, {
+            description: opts.desc || undefined,
+            all_day: opts.allDay,
+            repeat_type: opts.repeat,
+            reminder_type: opts.reminder,
+            rule: opts.rule || undefined,
+            expire_date_type: opts.expire || undefined,
+            attendee_permissions: opts.attendeePerms || undefined,
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
@@ -37,38 +65,48 @@ function registerCalendarCommands(program) {
     cmd
         .command("fetch-schedule")
         .description("Fetch a schedule by ID")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchSchedule(opts.calendarId, opts.scheduleId, { user_token: opts.userToken || undefined });
+        const result = await client.fetchSchedule(calendarId, scheduleId, {
+            user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
+        });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
     });
     cmd
         .command("delete-schedule")
         .description("Delete a schedule")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.deleteSchedule(opts.calendarId, opts.scheduleId, { user_token: opts.userToken || undefined });
+        const result = await client.deleteSchedule(calendarId, scheduleId, {
+            user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
+        });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
     });
     cmd
         .command("list-schedules")
         .description("List schedules in a time range")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--start-ts <startTs>", "Start timestamp (seconds)")
-        .requiredOption("--end-ts <endTs>", "End timestamp (seconds)")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<startTime>", "Start time (unix timestamp)")
+        .argument("<endTime>", "End time (unix timestamp)")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, startTime, endTime, opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchScheduleList(opts.calendarId, parseInt(opts.startTs), parseInt(opts.endTs), {
+        const result = await client.fetchScheduleList(calendarId, parseInt(startTime), parseInt(endTime), {
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
@@ -76,27 +114,39 @@ function registerCalendarCommands(program) {
     cmd
         .command("attendees")
         .description("Fetch schedule attendees")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .option("-p, --page <page>", "Page number", "1")
+        .option("-s, --size <size>", "Page size", "500")
+        .action(async (calendarId, scheduleId, opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchScheduleAttendees(opts.calendarId, opts.scheduleId, { user_token: opts.userToken || undefined });
+        const result = await client.fetchScheduleAttendees(calendarId, scheduleId, {
+            user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
+            page: parseInt(opts.page),
+            page_size: parseInt(opts.size),
+        });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
     });
     cmd
         .command("add-attendees")
         .description("Add attendees to a schedule")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .requiredOption("--attendees <ids>", "Comma-separated attendee staff IDs")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .argument("<attendees>", "Attendee staff IDs as JSON list: '[\"id1\",\"id2\"]'")
+        .option("--reminder <reminder>", "Reminder type: yes or no", "")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, attendees, opts) => {
         const client = (0, utils_1.getClient)();
-        const attendees = (0, utils_1.commaList)(opts.attendees);
-        const result = await client.addScheduleAttendees(opts.calendarId, opts.scheduleId, attendees, {
+        const attendeesList = (0, utils_1.parseJsonOption)(attendees);
+        const result = await client.addScheduleAttendees(calendarId, scheduleId, attendeesList, {
+            reminder_type: opts.reminder || undefined,
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
@@ -104,15 +154,19 @@ function registerCalendarCommands(program) {
     cmd
         .command("delete-attendees")
         .description("Remove attendees from a schedule")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .requiredOption("--attendees <ids>", "Comma-separated attendee staff IDs")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .argument("<attendees>", "Attendee staff IDs as JSON list")
+        .option("--reminder <reminder>", "Reminder type: yes or no", "")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, attendees, opts) => {
         const client = (0, utils_1.getClient)();
-        const attendees = (0, utils_1.commaList)(opts.attendees);
-        const result = await client.deleteScheduleAttendees(opts.calendarId, opts.scheduleId, attendees, {
+        const attendeesList = (0, utils_1.parseJsonOption)(attendees);
+        const result = await client.deleteScheduleAttendees(calendarId, scheduleId, attendeesList, {
+            reminder_type: opts.reminder || undefined,
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
@@ -120,15 +174,41 @@ function registerCalendarCommands(program) {
     cmd
         .command("update-schedule")
         .description("Update a schedule")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .option("--summary <summary>", "New summary/title")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .option("--summary <summary>", "New schedule summary", "")
+        .option("-d, --desc <desc>", "New description", "")
+        .option("--op <op>", "Operation type: modify_all, modify_current, modify_current_after", "modify_all")
+        .option("--current-time <time>", "Required when op != modify_all", "0")
+        .option("--reminder <reminder>", "Reminder type: yes or no", "")
+        .option("--repeat <repeat>", "Repeat type: no, day, week, month, year, work_day, custom", "")
+        .option("--rule <rule>", "RFC 5545 repeat rule", "")
+        .option("--expire <expire>", "Expire date type: yes or no", "")
+        .option("--all-day <allDay>", "All day: yes or no", "")
+        .option("--permissions <permissions>", "Attendee permissions: can_modify, can_invite, can_see, none", "")
+        .option("--start-time <json>", "Start time as JSON dict: {\"time\":..., \"date\":..., \"timeZone\":...}", "")
+        .option("--end-time <json>", "End time as JSON dict", "")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.updateSchedule(opts.calendarId, opts.scheduleId, {
+        const startTimeDict = opts.startTime ? (0, utils_1.parseJsonOption)(opts.startTime) : undefined;
+        const endTimeDict = opts.endTime ? (0, utils_1.parseJsonOption)(opts.endTime) : undefined;
+        const result = await client.updateSchedule(calendarId, scheduleId, {
             summary: opts.summary || undefined,
+            description: opts.desc || undefined,
+            operation_type: opts.op,
+            current_time: opts.currentTime ? parseInt(opts.currentTime) : undefined,
+            reminder_type: opts.reminder || undefined,
+            repeat_type: opts.repeat || undefined,
+            rule: opts.rule || undefined,
+            expire_date_type: opts.expire || undefined,
+            all_day: opts.allDay || undefined,
+            attendee_permissions: opts.permissions || undefined,
+            start_time: startTimeDict,
+            end_time: endTimeDict,
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);
@@ -136,20 +216,26 @@ function registerCalendarCommands(program) {
     cmd
         .command("attendee-meta")
         .description("Update attendee metadata (rsvp, busy/free, reminders)")
-        .requiredOption("--calendar-id <calendarId>", "Calendar ID")
-        .requiredOption("--schedule-id <scheduleId>", "Schedule ID")
-        .option("--rsvp-status <status>", "RSVP status")
-        .option("--busy-free-state <state>", "Busy/free state")
-        .option("--remind-times <times>", "Comma-separated reminder times (seconds before event)")
-        .option("--user-token <token>", "User token")
-        .action(async (opts) => {
+        .argument("<calendarId>", "Calendar ID")
+        .argument("<scheduleId>", "Schedule ID")
+        .option("--rsvp <rsvp>", "RSVP status: accept, tentative, decline", "")
+        .option("--color <color>", "Hex color (e.g. #FF347AFC)", "")
+        .option("--permissions <permissions>", "Visibility: private, public, default", "")
+        .option("--busy-free <state>", "Busy/free state: busy, free", "")
+        .option("--remind-times <json>", "Reminder offsets in minutes as JSON list, e.g. '[5,15]'", "")
+        .option("--user-token <token>", "User token", "")
+        .option("--user-id <userId>", "User ID", "")
+        .action(async (calendarId, scheduleId, opts) => {
         const client = (0, utils_1.getClient)();
-        const remindTimes = opts.remindTimes ? (0, utils_1.commaList)(opts.remindTimes).map(Number) : undefined;
-        const result = await client.updateScheduleAttendeeMeta(opts.calendarId, opts.scheduleId, {
-            rsvp_status: opts.rsvpStatus || undefined,
-            busy_free_state: opts.busyFreeState || undefined,
-            remind_times: remindTimes,
+        const remindTimesList = opts.remindTimes ? (0, utils_1.parseJsonOption)(opts.remindTimes) : undefined;
+        const result = await client.updateScheduleAttendeeMeta(calendarId, scheduleId, {
+            rsvp_status: opts.rsvp || undefined,
+            color: opts.color || undefined,
+            permissions: opts.permissions || undefined,
+            busy_free_state: opts.busyFree || undefined,
+            remind_times: remindTimesList,
             user_token: opts.userToken || undefined,
+            user_id: opts.userId || undefined,
         });
         (0, utils_1.checkError)(result);
         (0, utils_1.outputResult)(result);

package/dist/commands/callback.js

@@ -3,42 +3,93 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCallbackCommands = registerCallbackCommands;
 const utils_1 = require("../utils");
 const lansenger_sdk_ts_1 = require("lansenger-sdk-ts");
+function resolveEncodingKey(cliValue, profile) {
+    if (cliValue)
+        return cliValue;
+    const store = (0, utils_1.getStore)();
+    const creds = store.loadCredentials();
+    const val = creds.encoding_key || "";
+    if (val)
+        console.log(`Using encoding_key from credential store (profile: ${profile})`);
+    return val;
+}
+function resolveCallbackToken(cliValue, encodingKey, profile) {
+    if (cliValue)
+        return cliValue;
+    const store = (0, utils_1.getStore)();
+    const creds = store.loadCredentials();
+    const val = creds.callback_token || "";
+    if (val)
+        console.log(`Using callback_token from credential store (profile: ${profile})`);
+    return val;
+}
 function registerCallbackCommands(program) {
-    const cmd = program.command("callback").description("Parse and verify callback/webhook payloads");
+    const cmd = program.command("callback").description("Parse and verify callback events");
     cmd
         .command("parse-payload")
         .description("Parse an encrypted callback payload")
-        .requiredOption("--data <data>", "Encrypted callback data")
-        .option("--encoding-key <key>", "Encoding AES key")
-        .option("--verify-signature", "Verify signature before parsing", false)
-        .option("--timestamp <ts>", "Timestamp for signature verification")
-        .option("--nonce <nonce>", "Nonce for signature verification")
-        .option("--signature <sig>", "Signature for verification")
-        .option("--callback-token <token>", "Callback token for verification")
-        .action(async (opts) => {
-        const events = lansenger_sdk_ts_1.LansengerClient.parseCallbackPayload(opts.data, {
-            encoding_key: opts.encodingKey || "",
-            verify_signature: opts.verifySignature,
+        .argument("<encryptedData>", "Callback data (plain JSON or encrypted dataEncrypt value)")
+        .option("--encoding-key <key>", "Base64-encoded AES key for decryption (reads from credential store if empty)", "")
+        .option("--callback-token <token>", "Token for signature verification (reads from credential store if empty; falls back to encoding_key)", "")
+        .option("--known-app-id <appId>", "Known appId to help split orgId/appId during decryption", "")
+        .option("--verify-sig", "Verify signature before parsing", false)
+        .option("--timestamp <ts>", "Timestamp for signature verification", "")
+        .option("--nonce <nonce>", "Nonce for signature verification", "")
+        .option("--signature <sig>", "Signature to verify", "")
+        .option("-P, --profile <profile>", "Credential profile (overrides global --profile)", "")
+        .action(async (encryptedData, opts) => {
+        const p = opts.profile || utils_1.activeProfile;
+        const resolvedKey = resolveEncodingKey(opts.encodingKey, p);
+        const resolvedToken = resolveCallbackToken(opts.callbackToken, resolvedKey, p);
+        const events = lansenger_sdk_ts_1.LansengerClient.parseCallbackPayload(encryptedData, {
+            encoding_key: resolvedKey,
+            verify_signature: opts.verifySig,
             timestamp: opts.timestamp || "",
             nonce: opts.nonce || "",
             signature: opts.signature || "",
-            callback_token: opts.callbackToken || "",
+            callback_token: resolvedToken,
+            known_app_id: opts.knownAppId || "",
         });
         (0, utils_1.outputResult)(events);
     });
+    cmd
+        .command("decrypt-payload")
+        .description("Decrypt only (without parsing) a callback dataEncrypt value")
+        .argument("<encryptedData>", "Encrypted dataEncrypt value")
+        .option("--encoding-key <key>", "Base64-encoded AES key for decryption (reads from credential store if empty)", "")
+        .option("--known-app-id <appId>", "Known appId to help split orgId/appId in decrypted result", "")
+        .option("-P, --profile <profile>", "Credential profile (overrides global --profile)", "")
+        .action(async (encryptedData, opts) => {
+        const p = opts.profile || utils_1.activeProfile;
+        const resolvedKey = resolveEncodingKey(opts.encodingKey, p);
+        if (!resolvedKey) {
+            console.error("Error: encoding_key is required for decryption. Pass --encoding-key or set it via lansenger config set encoding_key.");
+            process.exit(1);
+        }
+        const result = (0, lansenger_sdk_ts_1.decryptCallbackPayload)(encryptedData, resolvedKey, opts.knownAppId || undefined);
+        (0, utils_1.outputResult)(result);
+    });
     cmd
         .command("verify-signature")
         .description("Verify callback signature")
-        .requiredOption("--timestamp <ts>", "Timestamp")
-        .requiredOption("--nonce <nonce>", "Nonce")
-        .requiredOption("--signature <sig>", "Signature")
-        .requiredOption("--encoding-key <key>", "Encoding AES key")
-        .option("--data-encrypt <data>", "Encrypted data for verification")
-        .option("--callback-token <token>", "Callback token")
-        .action(async (opts) => {
-        const valid = lansenger_sdk_ts_1.LansengerClient.verifyCallbackSignature(opts.timestamp, opts.nonce, opts.signature, opts.encodingKey, {
+        .argument("<timestamp>", "Timestamp")
+        .argument("<nonce>", "Nonce")
+        .argument("<signature>", "Signature")
+        .option("--encoding-key <key>", "Encoding key, used as token if callback-token not provided (reads from credential store if empty)", "")
+        .option("--data-encrypt <data>", "The encrypted dataEncrypt value (required for correct signature verification)", "")
+        .option("--callback-token <token>", "Token from developer center callback config (reads from credential store if empty; falls back to encoding_key)", "")
+        .option("-P, --profile <profile>", "Credential profile (overrides global --profile)", "")
+        .action(async (timestamp, nonce, signature, opts) => {
+        const p = opts.profile || utils_1.activeProfile;
+        const resolvedKey = resolveEncodingKey(opts.encodingKey, p);
+        if (!resolvedKey) {
+            console.error("Error: encoding_key is required for signature verification. Pass --encoding-key or set it via lansenger config set encoding_key.");
+            process.exit(1);
+        }
+        const resolvedToken = resolveCallbackToken(opts.callbackToken, resolvedKey, p);
+        const valid = lansenger_sdk_ts_1.LansengerClient.verifyCallbackSignature(timestamp, nonce, signature, resolvedKey, {
             data_encrypt: opts.dataEncrypt || "",
-            callback_token: opts.callbackToken || "",
+            callback_token: resolvedToken,
         });
         (0, utils_1.outputResult)({ valid });
     });

package/dist/commands/chat.js

@@ -2,32 +2,149 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerChatCommands = registerChatCommands;
 const utils_1 = require("../utils");
+function splitMonths(startUs, endUs) {
+    const results = [];
+    const startDt = startUs ? new Date(startUs / 1000000) : new Date(2020, 0, 1);
+    const endDt = new Date(endUs / 1000000);
+    let year = startDt.getFullYear();
+    let month = startDt.getMonth();
+    while (new Date(year, month, 1) <= endDt) {
+        const lastDay = new Date(year, month + 1, 0).getDate();
+        const msStart = Math.floor(new Date(year, month, 1).getTime() * 1000);
+        const msEnd = Math.floor(new Date(year, month, lastDay, 23, 59, 59).getTime() * 1000);
+        results.push([msStart, msEnd]);
+        month++;
+        if (month > 11) {
+            month = 0;
+            year++;
+        }
+    }
+    return results;
+}
 function registerChatCommands(program) {
-    const cmd = program.command("chat").description("View chat list and message history");
+    const cmd = program.command("chat").description("Chat list and message history");
     cmd
         .command("list")
         .description("Fetch chat list (private + group chats)")
-        .option("--user-token <token>", "User token")
+        .option("-t, --type <type>", "0=all, 1=private, 2=group", "0")
+        .option("-k, --keyword <keyword>", "Search keyword (only for type 1 or 2)", "")
+        .option("--start <start>", "Start time in microseconds", "0")
+        .option("--end <end>", "End time in microseconds", "0")
+        .option("--user-token <token>", "User token", "")
         .action(async (opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchChatList({ user_token: opts.userToken || undefined });
+        const result = await client.fetchChatList({
+            chat_type: parseInt(opts.type),
+            keyword: opts.keyword || undefined,
+            start_time: parseInt(opts.start),
+            end_time: parseInt(opts.end),
+            user_token: opts.userToken || undefined,
+        });
         (0, utils_1.checkError)(result);
-        (0, utils_1.outputResult)(result);
+        if (result.success) {
+            (0, utils_1.outputResult)(result);
+            if (result.staff_infos) {
+                (0, utils_1.outputList)(result.staff_infos, ["Staff ID", "Name", "Sectors"], (s) => [
+                    s.staff_id || "", s.staff_name || "", String(s.sector_names || ""),
+                ]);
+            }
+            if (result.group_infos) {
+                (0, utils_1.outputList)(result.group_infos, ["Group ID", "Name"], (g) => [
+                    g.group_id || "", g.group_name || "",
+                ]);
+            }
+        }
+        else {
+            (0, utils_1.outputResult)(result);
+        }
     });
     cmd
         .command("messages")
         .description("Fetch chat messages")
-        .option("--staff-id <staffId>", "Staff ID for private chat messages")
-        .option("--group-id <groupId>", "Group ID for group chat messages")
-        .option("--user-token <token>", "User token")
+        .option("--staff-id <staffId>", "Private chat partner staffId", "")
+        .option("--group-id <groupId>", "Group openId", "")
+        .option("-s, --size <size>", "Per-page count (max 100)", "100")
+        .option("--version <version>", "Deep pagination cursor, first call: 0", "0")
+        .option("--start <start>", "Start time in microseconds", "0")
+        .option("--end <end>", "End time in microseconds", "0")
+        .option("--sender-id <senderId>", "Filter by sender staffId", "")
+        .option("--split-month", "Auto-split query by month when range > 1 month", false)
+        .option("--progress", "Show pagination progress (pages/messages fetched)", false)
+        .option("--user-token <token>", "User token", "")
         .action(async (opts) => {
         const client = (0, utils_1.getClient)();
-        const result = await client.fetchChatMessages({
-            staff_id: opts.staffId || undefined,
-            group_id: opts.groupId || undefined,
-            user_token: opts.userToken || undefined,
-        });
-        (0, utils_1.checkError)(result);
-        (0, utils_1.outputResult)(result);
+        if (!opts.splitMonth) {
+            const result = await client.fetchChatMessages({
+                staff_id: opts.staffId || undefined,
+                group_id: opts.groupId || undefined,
+                page_size: parseInt(opts.size),
+                base_version: opts.version,
+                start_time: parseInt(opts.start),
+                end_time: parseInt(opts.end),
+                sender_id: opts.senderId || undefined,
+                user_token: opts.userToken || undefined,
+            });
+            (0, utils_1.checkError)(result);
+            if (result.success) {
+                (0, utils_1.outputResult)(result);
+                if (result.messages) {
+                    (0, utils_1.outputList)(result.messages, ["Time", "Sender", "Type"], (m) => [
+                        m.send_time || "", m.sender || "", m.message_type || "",
+                    ]);
+                }
+            }
+            else {
+                (0, utils_1.outputResult)(result);
+            }
+            return;
+        }
+        const allMessages = [];
+        let pageCount = 0;
+        let msgCount = 0;
+        const startUs = parseInt(opts.start) || 0;
+        const endUs = parseInt(opts.end) || Math.floor(Date.now() * 1000);
+        const months = splitMonths(startUs, endUs);
+        for (let i = 0; i < months.length; i++) {
+            const [msStart, msEnd] = months[i];
+            let cursor = "0";
+            while (true) {
+                const result = await client.fetchChatMessages({
+                    staff_id: opts.staffId || undefined,
+                    group_id: opts.groupId || undefined,
+                    page_size: parseInt(opts.size),
+                    base_version: cursor,
+                    start_time: msStart,
+                    end_time: msEnd,
+                    sender_id: opts.senderId || undefined,
+                    user_token: opts.userToken || undefined,
+                });
+                if (!result.success) {
+                    (0, utils_1.outputResult)(result);
+                    return;
+                }
+                pageCount++;
+                msgCount += result.messages ? result.messages.length : 0;
+                if (result.messages)
+                    allMessages.push(...result.messages);
+                if (opts.progress && !utils_1.jsonOutput) {
+                    console.log(`Month ${i + 1}/${months.length} | Page ${pageCount} | ${msgCount} messages total`);
+                }
+                if (!(result.messages && result.has_more))
+                    break;
+                cursor = String(result.last_version || "");
+            }
+        }
+        if (utils_1.jsonOutput) {
+            console.log(JSON.stringify(allMessages.map(m => m.toDict ? m.toDict() : m), null, 2));
+            return;
+        }
+        if (opts.progress) {
+            console.log(`Done: ${pageCount} pages, ${msgCount} messages across ${months.length} months`);
+        }
+        if (allMessages.length) {
+            (0, utils_1.outputList)(allMessages, ["Time", "Sender", "Type"], (m) => [
+                m.send_time || "", m.sender || "", m.message_type || "",
+            ]);
+        }
     });
 }