@northmoon-labs/social-cli 0.1.0

package/dist/utils/validation.js

@@ -0,0 +1,76 @@
+import { access } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { constants } from 'node:fs';
+import { value } from '../cli/args.js';
+import { CliError } from '../cli/output.js';
+import { MATERIAL_EXTENSIONS, PLATFORM_MAP } from '../social/types.js';
+export function platformOption(options, required = false) {
+    const raw = value(options, 'platform');
+    if (raw === undefined) {
+        if (required)
+            throw new CliError('VALIDATION_REQUIRED_OPTION', 'missing required option --platform');
+        return undefined;
+    }
+    const normalized = String(raw).toLowerCase();
+    if (PLATFORM_MAP[normalized])
+        return PLATFORM_MAP[normalized];
+    const numeric = Number(raw);
+    if ([1, 2, 3, 4].includes(numeric))
+        return numeric;
+    throw new CliError('VALIDATION_INVALID_OPTION', '--platform must be tiktok, youtube, instagram, facebook, or 1-4');
+}
+export function timeOption(options, key) {
+    const raw = value(options, key);
+    if (raw === undefined)
+        return undefined;
+    if (/^\d+$/.test(String(raw)))
+        return Number(raw);
+    return parseDateTime(raw, `--${key}`);
+}
+export function parseDateTime(raw, label) {
+    if (!/[zZ]|[+-]\d\d:\d\d$/.test(String(raw))) {
+        throw new CliError('VALIDATION_INVALID_OPTION', `${label} must include a timezone`);
+    }
+    const parsed = Date.parse(raw);
+    if (Number.isNaN(parsed))
+        throw new CliError('VALIDATION_INVALID_OPTION', `${label} must be a valid date time`);
+    return parsed;
+}
+export function dateOption(options, key) {
+    const raw = value(options, key);
+    if (raw === undefined)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(String(raw)))
+        throw new CliError('VALIDATION_INVALID_OPTION', `--${key} must use yyyy-MM-dd`);
+    return raw;
+}
+export function validateHttpUrl(raw, label) {
+    try {
+        const url = new URL(raw);
+        if (!['http:', 'https:'].includes(url.protocol))
+            throw new Error('invalid protocol');
+    }
+    catch {
+        throw new CliError('VALIDATION_INVALID_OPTION', `${label} must be an http(s) URL`);
+    }
+}
+export function validateMetric(metric, allowed) {
+    if (!allowed.includes(metric))
+        throw new CliError('VALIDATION_INVALID_OPTION', `unsupported metric: ${metric}`);
+}
+export async function validateUploadFile(file) {
+    try {
+        await access(file, constants.R_OK);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            throw new CliError('FILE_NOT_FOUND', `file not found: ${file}`);
+        throw new CliError('FILE_UNREADABLE', `file is not readable: ${file}`);
+    }
+    const ext = extname(file).slice(1).toLowerCase();
+    if (!MATERIAL_EXTENSIONS.has(ext))
+        throw new CliError('FILE_UNSUPPORTED_TYPE', `unsupported file type: ${ext || '(none)'}`);
+}
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@northmoon-labs/social-cli",
+  "version": "0.1.0",
+  "description": "Agent-ready CLI for Northmoon Social account authorization, publishing, comments, analytics, webhooks, and auto replies.",
+  "keywords": [
+    "northmoon",
+    "social",
+    "cli",
+    "social-api",
+    "publishing",
+    "tiktok",
+    "youtube",
+    "instagram",
+    "facebook",
+    "webhook",
+    "analytics"
+  ],
+  "type": "module",
+  "packageManager": "pnpm@10.33.2",
+  "bin": {
+    "nmsocial": "./dist/bin/nmsocial.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "skills"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "test": "pnpm run build && node --test --test-concurrency=1 tests/*.test.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.0"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cli-table3": "^0.6.5",
+    "picocolors": "^1.1.1"
+  }
+}

package/skills/nmsocial-cli/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: nmsocial-cli
+description: Instructions for AI agents that need to use the `nmsocial` command line tool to operate Northmoon Social workflows, including login, account authorization, material upload, publishing, tasks, posts, comments, webhooks, statistics, auto-replies, dry-run previews, and JSON output.
+---
+
+# NMSocial CLI
+
+Use this skill when an agent needs to call the `nmsocial` CLI on a user's machine.
+
+## Core Rules
+
+- Use the installed `nmsocial` command.
+- Treat the API URL as built into the CLI; do not ask the user to configure it unless they explicitly mention a custom endpoint.
+- Authenticate agents with `nmsocial login --api-key YOUR_KEY` when non-interactive execution is required.
+- Prefer `nmsocial login --api-key-stdin` for interactive human usage.
+- Do not put API keys directly in commands, logs, or responses.
+- Default output is compact text or tables for quick reading; do not parse it as a stable contract.
+- Use `--json` when another program or agent needs to parse the result.
+- Use `--dry-run --json` before mutation commands when confirming a request body is useful.
+- Prefer platform names: `tiktok`, `youtube`, `instagram`, `facebook`.
+- Use `nmsocial update check` to inspect CLI updates. Only run `nmsocial update` when the user explicitly asks to update the installed CLI.
+
+## Login
+
+```bash
+nmsocial login --api-key YOUR_KEY
+nmsocial login --api-key-stdin
+nmsocial status
+nmsocial logout
+```
+
+## CLI Updates
+
+```bash
+nmsocial update check
+nmsocial update --dry-run
+nmsocial update
+nmsocial update --manager npm
+nmsocial update --manager pnpm
+nmsocial update --manager bun
+```
+
+## Accounts
+
+```bash
+nmsocial auth-url --platform tiktok
+nmsocial accounts list --platform tiktok --status 1 --page 1 --page-size 20
+```
+
+## YouTube Series
+
+```bash
+nmsocial youtube series list --open-id CHANNEL_ID
+nmsocial youtube series create --open-id CHANNEL_ID --title "Demo Series" --description "Demo description"
+```
+
+## Materials
+
+```bash
+nmsocial materials list --type 1 --page 1 --page-size 20
+nmsocial materials upload ./demo.mp4
+```
+
+## Publishing
+
+Create video task:
+
+```bash
+nmsocial publish video --account OPEN_ID --content https://example.com/video.mp4 --caption "hello"
+```
+
+Create image task:
+
+```bash
+nmsocial publish image --account OPEN_ID --content https://example.com/a.png --content https://example.com/b.png --title "title"
+```
+
+Schedule task:
+
+```bash
+nmsocial publish video --account OPEN_ID --content https://example.com/video.mp4 --at 2026-07-18T10:00:00+08:00
+```
+
+Preview task:
+
+```bash
+nmsocial publish video --account OPEN_ID --content https://example.com/video.mp4 --dry-run --json
+```
+
+## Tasks And Posts
+
+```bash
+nmsocial tasks list --platform tiktok --page 1 --page-size 20
+nmsocial posts list --platform tiktok --open-id OPEN_ID
+nmsocial posts stats --platform tiktok --main-task-id TASK_ID
+```
+
+## Comments
+
+```bash
+nmsocial comments list --platform tiktok --open-id OPEN_ID
+nmsocial comments reply --platform tiktok --open-id OPEN_ID --video-id VIDEO_ID --comment-id COMMENT_ID --text "Thanks"
+```
+
+Preview reply:
+
+```bash
+nmsocial comments reply --platform tiktok --open-id OPEN_ID --video-id VIDEO_ID --comment-id COMMENT_ID --text "Thanks" --dry-run --json
+```
+
+## Webhook
+
+```bash
+nmsocial webhook set --url https://partner.example.com/spost/webhook
+nmsocial webhook disable
+```
+
+## Statistics
+
+```bash
+nmsocial stats overview --platform tiktok --start-date 2026-07-11 --end-date 2026-07-17
+nmsocial stats account trend --platform tiktok --metric followers
+nmsocial stats account rank --metric followerIncrease --order desc --page 1 --page-size 20
+nmsocial stats post trend --platform tiktok --metric viewCount
+nmsocial stats post rank --metric viewIncrease --order desc --page 1 --page-size 20
+nmsocial stats post detail-trend --post-id POST_ID --metric viewCount --metric likeCount
+nmsocial stats platform summary --start-date 2026-07-11 --end-date 2026-07-17
+```
+
+## Auto Replies
+
+```bash
+nmsocial auto-replies list --platform tiktok --page 1 --page-size 20
+nmsocial auto-replies detail --id STRATEGY_ID
+nmsocial auto-replies create --from-file ./auto-reply.json --dry-run --json
+nmsocial auto-replies update --id STRATEGY_ID --from-file ./auto-reply.json
+nmsocial auto-replies enable --id STRATEGY_ID
+nmsocial auto-replies disable --id STRATEGY_ID
+nmsocial auto-replies delete --id STRATEGY_ID
+```
+
+## Output
+
+Use `--json` for stable output:
+
+```json
+{
+  "ok": true,
+  "data": {},
+  "error": null,
+  "meta": {}
+}
+```
+
+On failure, inspect `error.code` and `error.message`.