@ardennguyen/zalo-agent-cli 2.5.8 → 3.0.0

package/src/commands/oa.js

@@ -1,208 +1,115 @@
 /**
- * Official Account (OA) commands — manage Zalo OA via REST API v3.0.
- * Independent from zca-js personal account; uses separate OA access token.
+ * Official Account (OA) commands: Zalo's official OA API (OAuth v4, OpenAPI v2.0/v3.0).
+ * Independent from the personal-account session; uses the OA's own access token (~/.zalo-agent/).
+ *
+ * This file holds the account-level commands (login, refresh, setup, whoami) and calls each area's register
+ * function: src/commands/oa/{messages,users,content,gmf,calls}.js, plus `oa listen` and `oa init`.
  */
 
-import { resolve } from "node:path";
 import { registerOAListenCommand } from "./oa-listen.js";
 import { registerOAInitCommand } from "./oa-init.js";
-import {
-    saveOAToken,
-    saveOACreds,
-    loadOACreds,
-    getOAuthUrl,
-    exchangeCode,
-    refreshAccessToken,
-    sendText,
-    sendImage,
-    sendFile,
-    sendList,
-    getMessageStatus,
-    getOAProfile,
-    getFollowerInfo,
-    getFollowers,
-    updateFollowerInfo,
-    getTags,
-    assignTag,
-    removeTag,
-    removeFollowerFromTag,
-    uploadImage,
-    uploadFile,
-    getRecentChat,
-    getConversation,
-    updateMenu,
-    createArticle,
-    getArticleList,
-    getArticleDetail,
-    createProduct,
-    getProductList,
-    getProductInfo,
-    createCategory,
-    getCategoryList,
-    createOrder,
-} from "../core/oa-client.js";
-import { success, error, info, warning, output } from "../utils/output.js";
+import { registerMessagesCommands } from "./oa/messages.js";
+import { registerUsersCommands } from "./oa/users.js";
+import { registerContentCommands } from "./oa/content.js";
+import { registerGmfCommands } from "./oa/gmf.js";
+import { registerCallsCommands } from "./oa/calls.js";
+import { saveOACreds, loadOACreds, getOAProfile } from "../core/oa-client.js";
+import { startOAuthLogin, openInBrowser, refreshStoredToken } from "../core/oa/oauth.js";
+import { success, error, info, output } from "../utils/output.js";
 
 /**
- * `oa whoami`'s lines for one OA profile (the `v2.0/oa/getoa` data).
+ * `oa whoami`'s lines for one OA profile (the `v2.0/oa/getoa` data, field names as Zalo's OA docs give them).
  *
- * The package tier is what decides which OA APIs work: the OA, ZBS and Article
- * APIs need a Verified OA on a paid Advanced/Premium package. getoa returns it
- * and this used to discard it, so "error -224" read as a mystery instead of
- * "this call needs a higher package".
+ * The package tier and verification decide which OA APIs work (-224 "upgrade the package", -221 "the OA must be
+ * verified"), so both are shown.
  *
  * @param {object} d - the profile data
  * @returns {string[]}
  */
 export function describeOAProfile(d = {}) {
-    const lines = [`OA: ${d.name || "N/A"} (ID: ${d.oa_id || "N/A"})`];
+    const has = (v) => v !== null && v !== undefined && v !== "";
+    const id = d.oa_id ?? d.oaid;
+    const lines = [`OA: ${d.name || "N/A"} (ID: ${has(id) ? id : "N/A"})`];
+    if (d.oa_alias) lines.push(`Alias: ${d.oa_alias}`);
     if (d.description) lines.push(`Description: ${d.description}`);
-    if (d.num_follower !== null && d.num_follower !== undefined) lines.push(`Followers: ${d.num_follower}`);
-    if (d.oa_type !== null && d.oa_type !== undefined) lines.push(`Type: ${d.oa_type}`);
+    if (has(d.is_verified)) lines.push(`Verified: ${d.is_verified ? "yes" : "no"}`);
+    if (has(d.oa_type)) {
+        const kind = { 2: "business", 4: "government" }[d.oa_type];
+        lines.push(`Type: ${d.oa_type}${kind ? ` (${kind})` : ""}`);
+    }
+    if (d.cate_name) lines.push(`Category: ${d.cate_name}`);
+    if (has(d.num_follower)) lines.push(`Followers: ${d.num_follower}`);
     if (d.package_name) {
-        const until = d.package_validThroughDate ? ` (valid through ${d.package_validThroughDate})` : "";
+        const until = d.package_valid_through_date ? ` (valid through ${d.package_valid_through_date})` : "";
         lines.push(`Package: ${d.package_name}${until}`);
     }
-    if (d.linked_zca !== null && d.linked_zca !== undefined) lines.push(`Linked ZCA: ${d.linked_zca}`);
+    if (d.package_auto_renew_date) lines.push(`Auto-renews: ${d.package_auto_renew_date}`);
+    const zca = d.linked_zca ?? d.linked_ZCA;
+    if (has(zca)) lines.push(`Linked ZCA: ${zca}`);
     return lines;
 }
 
+/** "25h" from an `expires_in` string of seconds. */
+function hours(expiresIn) {
+    const s = Number(expiresIn);
+    return Number.isFinite(s) && s > 0 ? `${Math.round(s / 3600)}h` : "unknown time";
+}
+
+/**
+ * Register the `oa` command group.
+ * @param {import("commander").Command} program
+ */
 export function registerOACommands(program) {
-    const oa = program.command("oa").description("Zalo Official Account API v3.0 commands");
+    const oa = program.command("oa").description("Zalo Official Account API commands (official API, OAuth)");
     const json = () => program.opts().json;
 
     // ─── Login & Auth ───────────────────────────────────────────────
 
     oa.command("login")
-        .description("Login to Zalo OA via OAuth (opens browser, starts callback server)")
+        .description("Log in to a Zalo OA via OAuth v4 with PKCE (opens the browser, waits on a local callback)")
         .requiredOption("--app-id <id>", "Zalo App ID from developers.zalo.me")
         .requiredOption("--secret <key>", "Zalo App Secret Key")
         .option("-p, --port <port>", "Callback server port", "3456")
-        .option("--callback-host <host>", "Callback host for VPS (e.g. https://your-vps.com)")
+        .option("--callback-host <host>", "Public callback base for a VPS (e.g. https://your-vps.com)")
         .option("--oa-id <id>", "OA identifier for multi-OA support", "default")
         .action(async (opts) => {
-            const { createServer } = await import("node:http");
-            const callbackBase = opts.callbackHost || `http://localhost:${opts.port}`;
-            const redirectUri = `${callbackBase}/callback`;
-            const authUrl = getOAuthUrl(opts.appId, redirectUri);
-
+            const flow = startOAuthLogin({
+                appId: opts.appId,
+                secretKey: opts.secret,
+                port: Number(opts.port),
+                callbackHost: opts.callbackHost,
+                oaId: opts.oaId,
+                onListening: ({ bindHost, port }) => {
+                    if (!json()) info(`Waiting for the callback on ${bindHost}:${port}...`);
+                },
+            });
             if (!json()) {
-                if (opts.callbackHost) {
-                    info("VPS mode — open this URL in your local browser:");
-                } else {
-                    info("Opening browser for Zalo OA authorization...");
-                }
-                info(`Auth URL:\n  ${authUrl}\n`);
+                info(opts.callbackHost ? "VPS mode: open this URL in your local browser:" : "Opening the browser...");
+                info(`Auth URL:\n  ${flow.authUrl}\n`);
             }
-
-            // Open browser (skip on VPS/headless — user copies URL manually)
-            if (!opts.callbackHost) {
-                const { exec } = await import("node:child_process");
-                const openCmd =
-                    process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-                exec(`${openCmd} "${authUrl}"`);
+            if (!opts.callbackHost) openInBrowser(flow.authUrl);
+            try {
+                const { tokenData, oaId } = await flow.done;
+                const shownId = oaId || opts.oaId;
+                output({ ok: true, oaId: shownId, expires_in: tokenData.expires_in }, json(), () => {
+                    success(`OA logged in (OA ID: ${shownId})`);
+                    info(`Token expires in ${hours(tokenData.expires_in)}; 'oa refresh' renews it`);
+                });
+            } catch (e) {
+                error(e.message);
             }
-
-            // Start callback server to receive authorization code
-            const server = createServer(async (req, res) => {
-                if (!req.url?.startsWith("/callback")) {
-                    res.writeHead(404);
-                    res.end();
-                    return;
-                }
-                const url = new URL(req.url, `http://localhost:${opts.port}`);
-                const code = url.searchParams.get("code");
-                const oaId = url.searchParams.get("oa_id");
-
-                if (!code) {
-                    const errMsg = url.searchParams.get("error_description") || "No authorization code received";
-                    res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
-                    res.end(`<h2>Login failed</h2><p>${errMsg}</p>`);
-                    if (!json()) error(errMsg);
-                    server.close();
-                    return;
-                }
-
-                try {
-                    // Exchange code for tokens
-                    const tokenData = await exchangeCode(code, opts.appId, opts.secret, redirectUri);
-
-                    if (tokenData.error) {
-                        throw new Error(
-                            `Token error ${tokenData.error}: ${tokenData.error_description || tokenData.error_name}`,
-                        );
-                    }
-
-                    // Save all credentials
-                    saveOACreds(
-                        {
-                            appId: opts.appId,
-                            secretKey: opts.secret,
-                            accessToken: tokenData.access_token,
-                            refreshToken: tokenData.refresh_token,
-                            expiresIn: tokenData.expires_in,
-                            oaId: oaId || opts.oaId,
-                        },
-                        opts.oaId,
-                    );
-
-                    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-                    res.end("<h2>Login successful!</h2><p>You can close this tab and return to the terminal.</p>");
-
-                    output({ ok: true, oaId: oaId || opts.oaId, expires_in: tokenData.expires_in }, json(), () => {
-                        success(`OA logged in successfully (OA ID: ${oaId || opts.oaId})`);
-                        info(
-                            `Token expires in ${Math.round((tokenData.expires_in || 86400) / 3600)}h — use 'oa refresh' to renew`,
-                        );
-                    });
-                } catch (e) {
-                    res.writeHead(500, { "Content-Type": "text/html; charset=utf-8" });
-                    res.end(`<h2>Login failed</h2><p>${e.message}</p>`);
-                    error(e.message);
-                } finally {
-                    server.close();
-                }
-            });
-
-            // Bind to 0.0.0.0 on VPS so external traffic can reach callback
-            const bindHost = opts.callbackHost ? "0.0.0.0" : "127.0.0.1";
-            server.listen(Number(opts.port), bindHost, () => {
-                if (!json()) info(`Waiting for callback on ${bindHost}:${opts.port}...`);
-            });
-
-            // Timeout after 2 minutes
-            setTimeout(() => {
-                if (!json()) warning("Login timed out (2 min). Try again.");
-                server.close();
-                process.exit(1);
-            }, 120_000);
         });
 
     oa.command("refresh")
-        .description("Refresh OA access token using stored refresh token")
+        .description("Refresh the OA access token with the stored refresh token (single use; serialized)")
         .option("--oa-id <id>", "OA identifier", "default")
         .action(async (opts) => {
             try {
-                const creds = loadOACreds(opts.oaId);
-                if (!creds?.refreshToken || !creds?.appId || !creds?.secretKey) {
-                    throw new Error("Missing credentials. Run: zalo-agent oa login --app-id <id> --secret <key>");
-                }
-                const tokenData = await refreshAccessToken(creds.refreshToken, creds.appId, creds.secretKey);
-                if (tokenData.error) {
-                    throw new Error(
-                        `Refresh error ${tokenData.error}: ${tokenData.error_description || tokenData.error_name}`,
-                    );
-                }
-                saveOACreds(
-                    {
-                        accessToken: tokenData.access_token,
-                        refreshToken: tokenData.refresh_token,
-                        expiresIn: tokenData.expires_in,
-                    },
-                    opts.oaId,
-                );
-                output({ ok: true, expires_in: tokenData.expires_in }, json(), () =>
-                    success(`Token refreshed. Expires in ${Math.round((tokenData.expires_in || 86400) / 3600)}h`),
+                const r = await refreshStoredToken(opts.oaId);
+                output({ ok: true, expires_in: r.expiresIn, expiresAt: r.expiresAt }, json(), () =>
+                    success(
+                        `Token refreshed. Expires in ${hours(r.expiresIn)}${r.expiresAt ? ` (${r.expiresAt})` : ""}`,
+                    ),
                 );
             } catch (e) {
                 error(e.message);
@@ -214,7 +121,8 @@ export function registerOACommands(program) {
         .option("--oa-id <id>", "OA identifier for multi-OA support", "default")
         .action(async (accessToken, opts) => {
             try {
-                saveOAToken(accessToken, opts.oaId);
+                // A hand-set token's lifetime is unknown: drop the stored expiry rather than show a wrong one.
+                saveOACreds({ accessToken, expiresIn: null, expiresAt: null }, opts.oaId);
                 output({ ok: true, oaId: opts.oaId }, json(), () => success(`OA token saved for "${opts.oaId}"`));
             } catch (e) {
                 error(e.message);
@@ -222,451 +130,28 @@ export function registerOACommands(program) {
         });
 
     oa.command("whoami")
-        .description("Show current OA profile info")
+        .description("Show the OA's profile: verification, type, category, package")
         .option("--oa-id <id>", "OA identifier", "default")
         .action(async (opts) => {
             try {
                 const result = await getOAProfile(opts.oaId);
                 output(result, json(), () => {
                     for (const line of describeOAProfile(result.data || result)) info(line);
+                    const expiresAt = loadOACreds(opts.oaId)?.expiresAt;
+                    if (expiresAt) info(`Token expires: ${expiresAt}`);
                 });
             } catch (e) {
                 error(e.message);
             }
         });
 
-    // ─── Messaging ───────────────────────────────────────────────────
-
-    const msg = oa.command("msg").description("Send messages to OA followers");
-
-    msg.command("text <user-id> <text>")
-        .description("Send text message to a follower")
-        .option("-m, --msg-type <type>", "Message type: cs | transaction | promotion", "cs")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, text, opts) => {
-            try {
-                const result = await sendText(userId, text, opts.msgType, opts.oaId);
-                output(result, json(), () => success("Text message sent"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    msg.command("image <user-id>")
-        .description("Send image message to a follower")
-        .option("--image-url <url>", "Image URL")
-        .option("--image-id <id>", "Pre-uploaded image attachment_id")
-        .option("-m, --msg-type <type>", "Message type: cs | transaction | promotion", "cs")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, opts) => {
-            try {
-                const result = await sendImage(
-                    userId,
-                    { imageUrl: opts.imageUrl, imageId: opts.imageId },
-                    opts.msgType,
-                    opts.oaId,
-                );
-                output(result, json(), () => success("Image message sent"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    msg.command("file <user-id> <file-id>")
-        .description("Send file message (requires pre-uploaded file token)")
-        .option("-m, --msg-type <type>", "Message type: cs | transaction | promotion", "cs")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, fileId, opts) => {
-            try {
-                const result = await sendFile(userId, fileId, opts.msgType, opts.oaId);
-                output(result, json(), () => success("File message sent"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    msg.command("list <user-id> <elements-json>")
-        .description('Send list message. elements-json: \'[{"title":"...", "subtitle":"..."}]\'')
-        .option("-m, --msg-type <type>", "Message type: cs | transaction | promotion", "cs")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, elementsJson, opts) => {
-            try {
-                const elements = JSON.parse(elementsJson);
-                const result = await sendList(userId, elements, opts.msgType, opts.oaId);
-                output(result, json(), () => success("List message sent"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    msg.command("status <message-id>")
-        .description("Check message delivery status")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (messageId, opts) => {
-            try {
-                const result = await getMessageStatus(messageId, opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    info(`Status: ${d.status || JSON.stringify(d)}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Followers ───────────────────────────────────────────────────
-
-    const follower = oa.command("follower").description("Manage OA followers");
-
-    follower
-        .command("info <user-id>")
-        .description("Get follower details")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, opts) => {
-            try {
-                const result = await getFollowerInfo(userId, opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    info(`Name: ${d.display_name || d.name || "N/A"}`);
-                    if (d.user_id) info(`User ID: ${d.user_id}`);
-                    if (d.user_id_by_app) info(`App User ID: ${d.user_id_by_app}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    follower
-        .command("list")
-        .description("List OA followers (paginated)")
-        .option("--offset <n>", "Offset", "0")
-        .option("--count <n>", "Count per page", "50")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getFollowers(Number(opts.offset), Number(opts.count), opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    const users = d.users || d.followers || [];
-                    info(`Followers: ${d.total || users.length}`);
-                    users.forEach((u) => console.log(`  - ${u.user_id}: ${u.display_name || "N/A"}`));
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    follower
-        .command("update <user-id> <updates-json>")
-        .description('Update follower info. updates-json: \'{"name":"...","phone":"..."}\'')
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, updatesJson, opts) => {
-            try {
-                const updates = JSON.parse(updatesJson);
-                const result = await updateFollowerInfo(userId, updates, opts.oaId);
-                output(result, json(), () => success("Follower info updated"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Tags ────────────────────────────────────────────────────────
-
-    const tag = oa.command("tag").description("Manage OA tags");
-
-    tag.command("list")
-        .description("List all tags")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getTags(opts.oaId);
-                output(result, json(), () => {
-                    const tags = result.data?.tags || result.tags || [];
-                    info(`Tags (${tags.length}):`);
-                    tags.forEach((t) => console.log(`  - ${t.name} (${t.count || 0} followers)`));
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    tag.command("assign <user-id> <tag-name>")
-        .description("Assign tag to a follower")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, tagName, opts) => {
-            try {
-                const result = await assignTag(userId, tagName, opts.oaId);
-                output(result, json(), () => success(`Tag "${tagName}" assigned`));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    tag.command("remove <tag-name>")
-        .description("Delete a tag")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (tagName, opts) => {
-            try {
-                const result = await removeTag(tagName, opts.oaId);
-                output(result, json(), () => success(`Tag "${tagName}" removed`));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    tag.command("untag <user-id> <tag-name>")
-        .description("Remove follower from a tag")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, tagName, opts) => {
-            try {
-                const result = await removeFollowerFromTag(userId, tagName, opts.oaId);
-                output(result, json(), () => success(`Removed "${tagName}" from user`));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Media Upload ────────────────────────────────────────────────
-
-    const upload = oa.command("upload").description("Upload media to OA");
+    // ─── Areas ───────────────────────────────────────────────────────
 
-    upload
-        .command("image <file-path>")
-        .description("Upload image (returns attachment_id for sending)")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (filePath, opts) => {
-            try {
-                const result = await uploadImage(resolve(filePath), opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    success(`Image uploaded: ${d.attachment_id || JSON.stringify(d)}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    upload
-        .command("file <file-path>")
-        .description("Upload file (returns token for sending)")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (filePath, opts) => {
-            try {
-                const result = await uploadFile(resolve(filePath), opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    success(`File uploaded: ${d.token || JSON.stringify(d)}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Conversations ───────────────────────────────────────────────
-
-    const conv = oa.command("conv").description("OA conversations");
-
-    conv.command("recent")
-        .description("List recent conversations")
-        .option("--offset <n>", "Offset", "0")
-        .option("--count <n>", "Count", "10")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getRecentChat(Number(opts.offset), Number(opts.count), opts.oaId);
-                output(result, json(), () => {
-                    const chats = result.data || [];
-                    info(`Recent conversations: ${Array.isArray(chats) ? chats.length : "see JSON"}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    conv.command("history <user-id>")
-        .description("Get conversation history with a follower")
-        .option("--offset <n>", "Offset", "0")
-        .option("--count <n>", "Count", "10")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (userId, opts) => {
-            try {
-                const result = await getConversation(userId, Number(opts.offset), Number(opts.count), opts.oaId);
-                output(result, json(), () => {
-                    const msgs = result.data || [];
-                    info(`Messages: ${Array.isArray(msgs) ? msgs.length : "see JSON"}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Menu ────────────────────────────────────────────────────────
-
-    oa.command("menu <menu-json>")
-        .description("Update OA menu. menu-json: '{\"buttons\":[...]}'")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (menuJson, opts) => {
-            try {
-                const menuData = JSON.parse(menuJson);
-                const result = await updateMenu(menuData, opts.oaId);
-                output(result, json(), () => success("OA menu updated"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Articles ────────────────────────────────────────────────────
-
-    const article = oa.command("article").description("Manage OA articles/broadcasts");
-
-    article
-        .command("create <article-json>")
-        .description("Create article (broadcast)")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (articleJson, opts) => {
-            try {
-                const data = JSON.parse(articleJson);
-                const result = await createArticle(data, opts.oaId);
-                output(result, json(), () => success("Article created"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    article
-        .command("list")
-        .description("List articles")
-        .option("--offset <n>", "Offset", "0")
-        .option("--limit <n>", "Limit", "10")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getArticleList(Number(opts.offset), Number(opts.limit), opts.oaId);
-                output(result, json(), () => {
-                    // v2.0/article/getslice returns medias (not articles)
-                    const articles = result.data?.medias || result.data?.articles || [];
-                    info(`Articles: ${articles.length}`);
-                    articles.forEach((a) => console.log(`  - ${a.id}: ${a.title || "N/A"} [${a.status || ""}]`));
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    article
-        .command("detail <article-id>")
-        .description("Get article details")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (articleId, opts) => {
-            try {
-                const result = await getArticleDetail(articleId, opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    info(`Title: ${d.title || "N/A"}`);
-                    if (d.status) info(`Status: ${d.status}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    // ─── Store ───────────────────────────────────────────────────────
-
-    const store = oa.command("store").description("Manage OA store (products, categories, orders)");
-
-    store
-        .command("product-create <product-json>")
-        .description("Create product in OA store")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (productJson, opts) => {
-            try {
-                const data = JSON.parse(productJson);
-                const result = await createProduct(data, opts.oaId);
-                output(result, json(), () => success("Product created"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    store
-        .command("product-list")
-        .description("List products")
-        .option("--offset <n>", "Offset", "0")
-        .option("--limit <n>", "Limit", "10")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getProductList(Number(opts.offset), Number(opts.limit), opts.oaId);
-                output(result, json(), () => {
-                    const products = result.data?.products || [];
-                    info(`Products: ${products.length}`);
-                    products.forEach((p) => console.log(`  - ${p.id}: ${p.name || "N/A"}`));
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    store
-        .command("product-info <product-id>")
-        .description("Get product details")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (productId, opts) => {
-            try {
-                const result = await getProductInfo(productId, opts.oaId);
-                output(result, json(), () => {
-                    const d = result.data || result;
-                    info(`Product: ${d.name || "N/A"} — ${d.price || "N/A"}`);
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    store
-        .command("category-create <category-json>")
-        .description("Create store category")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (categoryJson, opts) => {
-            try {
-                const data = JSON.parse(categoryJson);
-                const result = await createCategory(data, opts.oaId);
-                output(result, json(), () => success("Category created"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    store
-        .command("category-list")
-        .description("List store categories")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (opts) => {
-            try {
-                const result = await getCategoryList(opts.oaId);
-                output(result, json(), () => {
-                    const cats = result.data?.categories || [];
-                    info(`Categories: ${cats.length}`);
-                    cats.forEach((c) => console.log(`  - ${c.id}: ${c.name || "N/A"}`));
-                });
-            } catch (e) {
-                error(e.message);
-            }
-        });
-
-    store
-        .command("order-create <order-json>")
-        .description("Create order")
-        .option("--oa-id <id>", "OA identifier", "default")
-        .action(async (orderJson, opts) => {
-            try {
-                const data = JSON.parse(orderJson);
-                const result = await createOrder(data, opts.oaId);
-                output(result, json(), () => success("Order created"));
-            } catch (e) {
-                error(e.message);
-            }
-        });
+    registerMessagesCommands(oa);
+    registerUsersCommands(oa);
+    registerContentCommands(oa);
+    registerGmfCommands(oa);
+    registerCallsCommands(oa);
 
     // ─── Webhook Listener ────────────────────────────────────────────