wldx-cli 1.0.0 → 1.1.0

package/src/commands/channel.mjs

@@ -1,16 +1,42 @@
 // wx channel: channels of the Wildix stream service and their members, as the logged-in user (the agent skill's
 // channels.sh, members.sh and search.sh channels).
-import {UsageError} from '../errors.mjs';
-import {localTime, paint, table} from '../format.mjs';
-import {apiPath, query} from '../http.mjs';
+import {UsageError} from 'wldx-core/errors';
+import {localTime, paint, table} from 'wldx-core/format';
+import {apiPath, query} from 'wldx-core/http';
 import {channelId} from '../stream.mjs';
 import {channelDetails, channelLines, channelUserIds, done, nextPage} from '../chat/format.mjs';
-import {CHANNEL_ID, NOT_IMPLEMENTED, api, checkId, checkInt, nameIn, newChannelId, notImplemented, withNames} from '../chat/lib.mjs';
+import {
+  CHANNEL_ID,
+  NOT_IMPLEMENTED,
+  api,
+  checkId,
+  checkInt,
+  nameIn,
+  newChannelId,
+  notImplemented,
+  withNames,
+} from '../chat/lib.mjs';
 
 const ACCESS = ['private', 'public'];
 const UNSET = [
-  'subject', 'description', 'picture', 'pictureColor', 'access', 'broadcast', 'context', 'contextPtt', 'contextEvents', 'whatsappStatus',
-  'messagingStatus', 'kiteAssign', 'service', 'serviceTitle', 'assignee', 'sms', 'mms', 'whatsapp',
+  'subject',
+  'description',
+  'picture',
+  'pictureColor',
+  'access',
+  'broadcast',
+  'context',
+  'contextPtt',
+  'contextEvents',
+  'whatsappStatus',
+  'messagingStatus',
+  'kiteAssign',
+  'service',
+  'serviceTitle',
+  'assignee',
+  'sms',
+  'mms',
+  'whatsapp',
 ];
 const SORT = ['relevance', 'recency', 'recency_asc'];
 const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
@@ -20,7 +46,8 @@ function email(value, what = '--invite') {
   return value;
 }
 
-const channelResult = async (ctx, client, r) => withNames(ctx, r, [...channelUserIds(r?.channel), r?.channel?.createdBy], client);
+const channelResult = async (ctx, client, r) =>
+  withNames(ctx, r, [...channelUserIds(r?.channel), r?.channel?.createdBy], client);
 const channelText = (r, ctx) => (r?.channel ? channelDetails(r.channel, r, ctx) : 'No channel.');
 
 const get = {
@@ -52,7 +79,8 @@ const queryCmd = {
 
 const search = {
   summary: 'search your channels by subject or member',
-  usage: 'wx channel search <query> [--type direct|group] [--member USERID] [--size 1-50] [--cursor C] [--sort relevance|recency|recency_asc]',
+  usage:
+    'wx channel search <query> [--type direct|group] [--member USERID] [--size 1-50] [--cursor C] [--sort relevance|recency|recency_asc]',
   options: {
     type: {type: 'string', choices: ['direct', 'group'], description: 'only 1:1 or group channels'},
     member: {type: 'string', placeholder: 'USERID', description: 'only channels with this member'},
@@ -73,7 +101,12 @@ const search = {
     });
     const client = api(ctx);
     const r = await client.call('GET', `/search/channels${q}`);
-    return withNames(ctx, r, (r?.results ?? []).flatMap((x) => channelUserIds(x.channel)), client);
+    return withNames(
+      ctx,
+      r,
+      (r?.results ?? []).flatMap((x) => channelUserIds(x.channel)),
+      client,
+    );
   },
   text(r, ctx) {
     const list = (r?.results ?? []).map((x) => x.channel).filter(Boolean);
@@ -84,7 +117,8 @@ const search = {
 
 const create = {
   summary: 'create a group channel',
-  usage: 'wx channel create --subject S [--description D] [--access private|public] [--member USERID]... [--invite EMAIL]... [--id 8-4-4-4-8] [--auto-transcribe | --no-auto-transcribe]',
+  usage:
+    'wx channel create --subject S [--description D] [--access private|public] [--member USERID]... [--invite EMAIL]... [--id 8-4-4-4-8] [--auto-transcribe | --no-auto-transcribe]',
   details: [
     'An id of 8-4-4-4-8 characters is always sent (one is made when --id is not given): without it the service makes',
     'a 36-character id that none of its own calls accepts. --auto-transcribe makes a conference in the channel start',
@@ -104,7 +138,8 @@ const create = {
   async run(ctx) {
     const {values} = ctx;
     if (!values.subject) throw new UsageError('--subject is required', ctx.usage());
-    if (values['auto-transcribe'] && values['no-auto-transcribe']) throw new UsageError('Give --auto-transcribe or --no-auto-transcribe, not both', ctx.usage());
+    if (values['auto-transcribe'] && values['no-auto-transcribe'])
+      throw new UsageError('Give --auto-transcribe or --no-auto-transcribe, not both', ctx.usage());
     const id = values.id ?? newChannelId();
     if (!CHANNEL_ID.test(id)) throw new UsageError(`--id must look like 8-4-4-4-8 characters of [0-9a-z_]: ${id}`);
     const body = {channelId: id, subject: values.subject};
@@ -138,7 +173,11 @@ const direct = {
   args: [0, 0],
   async run(ctx) {
     const client = api(ctx);
-    return channelResult(ctx, client, await client.call('POST', '/channels/direct/get-or-create', directBody(ctx.values, ctx.usage())));
+    return channelResult(
+      ctx,
+      client,
+      await client.call('POST', '/channels/direct/get-or-create', directBody(ctx.values, ctx.usage())),
+    );
   },
   text: channelText,
 };
@@ -171,7 +210,8 @@ const update = {
     const set = {};
     for (const k of ['subject', 'description', 'access']) if (values[k] !== undefined) set[k] = values[k];
     const unset = values.unset ?? [];
-    if (!Object.keys(set).length && !unset.length) throw new UsageError('Nothing to change: give --subject, --description, --access or --unset', ctx.usage());
+    if (!Object.keys(set).length && !unset.length)
+      throw new UsageError('Nothing to change: give --subject, --description, --access or --unset', ctx.usage());
     const body = {set};
     if (unset.length) body.unset = unset;
     return api(ctx).call('PATCH', apiPath`/channels/${ch}`, body);
@@ -200,7 +240,11 @@ const del = {
   args: [1, 1],
   async run(ctx) {
     const ch = channelId(ctx.positionals[0]);
-    if (!ctx.values.yes) throw new UsageError('delete removes the channel for everyone: confirm with the person, then add --yes', ctx.usage());
+    if (!ctx.values.yes)
+      throw new UsageError(
+        'delete removes the channel for everyone: confirm with the person, then add --yes',
+        ctx.usage(),
+      );
     return api(ctx).call('DELETE', apiPath`/channels/${ch}`);
   },
   text: done('Deleted'),
@@ -216,16 +260,26 @@ const members = {
   args: [1, 1],
   async run(ctx) {
     const ch = channelId(ctx.positionals[0]);
-    const q = query({limit: checkInt('limit', ctx.values.limit, 1, 100), offset: checkInt('offset', ctx.values.offset, 0, 1000)});
+    const q = query({
+      limit: checkInt('limit', ctx.values.limit, 1, 100),
+      offset: checkInt('offset', ctx.values.offset, 0, 1000),
+    });
     const client = api(ctx);
     const r = await client.call('GET', apiPath`/channels/${ch}/members` + q);
-    return withNames(ctx, r, (r?.members ?? []).map((m) => m.userId), client);
+    return withNames(
+      ctx,
+      r,
+      (r?.members ?? []).map((m) => m.userId),
+      client,
+    );
   },
   text(r, ctx) {
     const c = paint(ctx);
     const list = r?.members ?? [];
     if (!list.length) return 'No members.';
-    return table(list.map((m) => [c.bold(nameIn(r, m.userId)), m.userId, m.role ?? '', c.dim(`joined ${localTime(m.joinedAt)}`)]));
+    return table(
+      list.map((m) => [c.bold(nameIn(r, m.userId)), m.userId, m.role ?? '', c.dim(`joined ${localTime(m.joinedAt)}`)]),
+    );
   },
 };
 
@@ -242,7 +296,17 @@ const member = {
     const r = await client.call('GET', apiPath`/channels/${ch}/members/${user}`);
     return withNames(ctx, r, [r?.member?.userId], client);
   },
-  text: (r, ctx) => (r?.member ? table([[paint(ctx).bold(nameIn(r, r.member.userId)), r.member.userId, r.member.role ?? '', `joined ${localTime(r.member.joinedAt)}`]]) : 'No member.'),
+  text: (r, ctx) =>
+    r?.member
+      ? table([
+          [
+            paint(ctx).bold(nameIn(r, r.member.userId)),
+            r.member.userId,
+            r.member.role ?? '',
+            `joined ${localTime(r.member.joinedAt)}`,
+          ],
+        ])
+      : 'No member.',
 };
 
 const add = {
@@ -291,13 +355,24 @@ const readStatus = {
     const ch = channelId(ctx.positionals[0]);
     const client = api(ctx);
     const r = await client.call('GET', apiPath`/channels/${ch}/read-status`);
-    return withNames(ctx, r, (r?.members ?? []).map((m) => m.userId), client);
+    return withNames(
+      ctx,
+      r,
+      (r?.members ?? []).map((m) => m.userId),
+      client,
+    );
   },
   text(r, ctx) {
     const c = paint(ctx);
     const list = r?.members ?? [];
     if (!list.length) return 'No members.';
-    return table(list.map((m) => [c.bold(nameIn(r, m.userId)), m.lastReadVisibleSeq === undefined ? c.dim('nothing read') : `up to #${m.lastReadVisibleSeq}`, c.dim(localTime(m.lastReadAt))]));
+    return table(
+      list.map((m) => [
+        c.bold(nameIn(r, m.userId)),
+        m.lastReadVisibleSeq === undefined ? c.dim('nothing read') : `up to #${m.lastReadVisibleSeq}`,
+        c.dim(localTime(m.lastReadAt)),
+      ]),
+    );
   },
 };
 
@@ -312,7 +387,10 @@ const channel = {
     direct,
     'direct-id': directId,
     update,
-    join: simple('join', `join a public channel${NOT_IMPLEMENTED}`, 'POST', '/join', {details: notImplemented('JoinChannel'), text: 'Joined'}),
+    join: simple('join', `join a public channel${NOT_IMPLEMENTED}`, 'POST', '/join', {
+      details: notImplemented('JoinChannel'),
+      text: 'Joined',
+    }),
     leave: simple('leave', 'leave a channel', 'POST', '/leave', {text: 'Left'}),
     delete: del,
     members,

package/src/commands/chat.mjs

@@ -1,12 +1,24 @@
 // wx chat: channels and messages of the Wildix stream service, as the logged-in user (the agent skill's
 // messages.sh, mentions.sh, search.sh messages and watch.sh). The inbox state is `wx inbox`, channels and their
 // members `wx channel`, files `wx file`, people `wx user`.
-import {AuthError, UsageError} from '../errors.mjs';
-import {localTime, oneLine, paint, table} from '../format.mjs';
-import {apiPath, query} from '../http.mjs';
+import {AuthError, UsageError} from 'wldx-core/errors';
+import {localTime, oneLine, paint, table} from 'wldx-core/format';
+import {apiPath, query} from 'wldx-core/http';
 import {channelId, messageId} from '../stream.mjs';
 import {channelLines, channelUserIds, done, messageLines, messageText, nextPage} from '../chat/format.mjs';
-import {api, attachmentOf, checkId, checkInt, checkReaction, meId, messageUserIds, nameIn, readText, uploadFile, withNames} from '../chat/lib.mjs';
+import {
+  api,
+  attachmentOf,
+  checkId,
+  checkInt,
+  checkReaction,
+  meId,
+  messageUserIds,
+  nameIn,
+  readText,
+  uploadFile,
+  withNames,
+} from '../chat/lib.mjs';
 import {EVENT_CHOICES, EVENT_GROUPS, eventText, watch} from '../chat/watch.mjs';
 
 const SEQ_MAX = 999_999_999_999;
@@ -19,7 +31,8 @@ async function ownMessage(ctx, client, ch, msg) {
   const r = await client.call('GET', apiPath`/channels/${ch}/messages/${msg}`);
   const author = r?.message?.userId;
   const me = await meId(ctx, client);
-  if (!author || author !== me) throw new AuthError(`The message is not yours (author: ${author ?? 'unknown'}, you: ${me}). Nothing was changed.`);
+  if (!author || author !== me)
+    throw new AuthError(`The message is not yours (author: ${author ?? 'unknown'}, you: ${me}). Nothing was changed.`);
   return r.message;
 }
 
@@ -36,7 +49,9 @@ export function editBody(message, text, markdown) {
     forward: ref(message.forward),
     markdown: markdown ? true : message.markdown,
   };
-  return Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined && v !== null && !(Array.isArray(v) && !v.length)));
+  return Object.fromEntries(
+    Object.entries(body).filter(([, v]) => v !== undefined && v !== null && !(Array.isArray(v) && !v.length)),
+  );
 }
 
 const sentText = (verb) => (r, ctx) => {
@@ -56,7 +71,10 @@ const list = {
   async run(ctx) {
     const {values} = ctx;
     const client = api(ctx);
-    const r = await client.call('GET', `/channels${query({filter: values.filter, section: values.section, cursor: values.cursor})}`);
+    const r = await client.call(
+      'GET',
+      `/channels${query({filter: values.filter, section: values.section, cursor: values.cursor})}`,
+    );
     return withNames(ctx, r, (r?.channels ?? []).flatMap(channelUserIds), client);
   },
   text(r, ctx) {
@@ -91,7 +109,8 @@ const read = {
     if (!messages.length) return 'No messages.';
     const lines = messageLines(messages, r, ctx);
     const oldest = Math.min(...messages.map((m) => m.timelineSeq ?? Infinity));
-    if (messages.length >= 30 && Number.isFinite(oldest) && oldest > 0) lines.push(paint(ctx).dim(`Older: --to ${oldest - 1}`));
+    if (messages.length >= 30 && Number.isFinite(oldest) && oldest > 0)
+      lines.push(paint(ctx).dim(`Older: --to ${oldest - 1}`));
     return lines;
   },
 };
@@ -99,7 +118,8 @@ const read = {
 const send = {
   summary: 'send a message to a channel ("-" reads the text from stdin)',
   usage: 'wx chat send <channel> <text|-> [--markdown] [--reply-to MESSAGE] [--mention USERID]... [--file PATH]...',
-  details: 'Sends as the logged-in user. --file uploads the file and attaches it (files in credential folders are refused).',
+  details:
+    'Sends as the logged-in user. --file uploads the file and attaches it (files in credential folders are refused).',
   options: {
     markdown: {type: 'boolean', description: 'the text is markdown'},
     'reply-to': {type: 'string', description: 'quote this message (id or inbox link)'},
@@ -151,8 +171,11 @@ const get = {
     ];
     if (m.quote) rows.push(['Reply to', `${nameIn(r, m.quote.userId)}: ${oneLine(m.quote.text ?? '', 100)}`]);
     if (m.mentions?.length) rows.push(['Mentions', m.mentions.map((id) => nameIn(r, id)).join(', ')]);
-    for (const f of m.attachments ?? []) rows.push(['File', `${f.name} (${f.mime ?? '?'}, ${f.size ?? '?'} bytes) fsId ${f.fsId}`]);
-    const counts = Object.entries(m.reactionCounts ?? {}).map(([t, n]) => `${t} ${n}`).join(', ');
+    for (const f of m.attachments ?? [])
+      rows.push(['File', `${f.name} (${f.mime ?? '?'}, ${f.size ?? '?'} bytes) fsId ${f.fsId}`]);
+    const counts = Object.entries(m.reactionCounts ?? {})
+      .map(([t, n]) => `${t} ${n}`)
+      .join(', ');
     if (counts) rows.push(['Reactions', counts]);
     if (m.pinned) rows.push(['Pinned', `${localTime(m.pinnedAt)}${m.pinnedBy ? ` by ${nameIn(r, m.pinnedBy)}` : ''}`]);
     const body = m.messageType === 'deleted' || m.deletedAt ? ['(deleted)'] : String(m.text ?? '').split('\n');
@@ -184,12 +207,17 @@ const edit = {
 const del = {
   summary: 'delete your own message, for everyone (needs --yes)',
   usage: 'wx chat delete <channel> <message> --yes',
-  details: 'Only your own messages (else exit 2, nothing changed). Confirm with the person first: --yes is not the confirmation.',
+  details:
+    'Only your own messages (else exit 2, nothing changed). Confirm with the person first: --yes is not the confirmation.',
   options: {yes: {type: 'boolean', description: 'yes, delete it for everyone'}},
   args: [2, 2],
   async run(ctx) {
     const {ch, msg} = target(ctx.positionals);
-    if (!ctx.values.yes) throw new UsageError('delete removes the message for everyone: confirm with the person, then add --yes', ctx.usage());
+    if (!ctx.values.yes)
+      throw new UsageError(
+        'delete removes the message for everyone: confirm with the person, then add --yes',
+        ctx.usage(),
+      );
     const client = api(ctx);
     await ownMessage(ctx, client, ch, msg);
     return client.call('DELETE', apiPath`/channels/${ch}/messages/${msg}`);
@@ -226,7 +254,8 @@ const reactCmd = (add) => ({
 const reactions = {
   summary: 'who reacted to a message: one entry per person and type',
   usage: 'wx chat reactions <channel> <message> [--type TYPE] [--users]',
-  details: 'The JSON gives user ids; --users adds the name, e-mail and bot of each (the text output always shows names).',
+  details:
+    'The JSON gives user ids; --users adds the name, e-mail and bot of each (the text output always shows names).',
   options: {
     type: {type: 'string', description: 'only this reaction type'},
     users: {type: 'boolean', description: 'add the name, e-mail and bot of each person (JSON)'},
@@ -269,8 +298,16 @@ const mentions = {
   args: [0, 0],
   async run(ctx) {
     const client = api(ctx);
-    const r = await client.call('GET', `/mentions${query({filter: ctx.values.unread && 'unread', cursor: ctx.values.cursor})}`);
-    return withNames(ctx, r, (r?.mentions ?? []).flatMap((x) => [...messageUserIds(x.message), x.channel?.peerId]), client);
+    const r = await client.call(
+      'GET',
+      `/mentions${query({filter: ctx.values.unread && 'unread', cursor: ctx.values.cursor})}`,
+    );
+    return withNames(
+      ctx,
+      r,
+      (r?.mentions ?? []).flatMap((x) => [...messageUserIds(x.message), x.channel?.peerId]),
+      client,
+    );
   },
   text(r, ctx) {
     const c = paint(ctx);
@@ -291,7 +328,8 @@ const SORT = ['relevance', 'recency', 'recency_asc'];
 
 const search = {
   summary: 'search messages in your channels',
-  usage: 'wx chat search <query> [--channel C] [--sender USERID]... [--attachments] [--links] [--size 1-50] [--cursor C] [--sort relevance|recency|recency_asc]',
+  usage:
+    'wx chat search <query> [--channel C] [--sender USERID]... [--attachments] [--links] [--size 1-50] [--cursor C] [--sort relevance|recency|recency_asc]',
   options: {
     channel: {type: 'string', description: 'only in this channel (id or inbox link)'},
     sender: {type: 'string', multiple: true, placeholder: 'USERID', description: 'only messages of this person'},
@@ -316,7 +354,12 @@ const search = {
     });
     const client = api(ctx);
     const r = await client.call('GET', `/search/messages${q}`);
-    return withNames(ctx, r, (r?.results ?? []).flatMap((x) => messageUserIds(x.message)), client);
+    return withNames(
+      ctx,
+      r,
+      (r?.results ?? []).flatMap((x) => messageUserIds(x.message)),
+      client,
+    );
   },
   text(r, ctx) {
     const c = paint(ctx);
@@ -335,7 +378,8 @@ const search = {
 
 const watchCmd = {
   summary: 'follow your chats live: messages, reactions, reads, members, channel changes',
-  usage: 'wx chat watch [--channel C]... [--from USERID]... [--type TYPE]... [--mine] [--count N] [--for SECONDS] [--raw]',
+  usage:
+    'wx chat watch [--channel C]... [--from USERID]... [--type TYPE]... [--mine] [--count N] [--for SECONDS] [--raw]',
   details: [
     'Read only: nothing is sent and nothing is marked read. One line per event (one JSON object per line with',
     '--output json): READY when listening, then message.new, reaction.new, read.receipt.updated, member.added,',
@@ -348,8 +392,18 @@ const watchCmd = {
   ].join('\n'),
   options: {
     channel: {type: 'string', multiple: true, placeholder: 'C', description: 'only this channel (id or inbox link)'},
-    from: {type: 'string', multiple: true, placeholder: 'USERID', description: 'only what this person did (messages, reading, typing)'},
-    type: {type: 'string', multiple: true, choices: EVENT_CHOICES, description: 'only these events: a group or one event'},
+    from: {
+      type: 'string',
+      multiple: true,
+      placeholder: 'USERID',
+      description: 'only what this person did (messages, reading, typing)',
+    },
+    type: {
+      type: 'string',
+      multiple: true,
+      choices: EVENT_CHOICES,
+      description: 'only these events: a group or one event',
+    },
     mine: {type: 'boolean', description: 'also what you did yourself'},
     count: {type: 'string', placeholder: 'N', description: 'stop after N events (1-100000)'},
     for: {type: 'string', placeholder: 'SECONDS', description: 'stop after this long (1-604800)'},
@@ -370,7 +424,8 @@ const watchCmd = {
     });
   },
   textEvent(e, ctx) {
-    if (ctx.values.raw && !['READY', 'RECONNECTING', 'RECONNECTED', 'END'].includes(e.event)) return `${e.event} ${JSON.stringify(e)}`;
+    if (ctx.values.raw && !['READY', 'RECONNECTING', 'RECONNECTED', 'END'].includes(e.event))
+      return `${e.event} ${JSON.stringify(e)}`;
     return eventText(e, ctx);
   },
 };