@hesed/gchat 0.3.1 → 0.4.0

package/README.md

@@ -26,7 +26,7 @@ $ npm install -g @hesed/gchat
 $ gchat COMMAND
 running command...
 $ gchat (--version)
-@hesed/gchat/0.3.1 linux-x64 node-v24.19.0
+@hesed/gchat/0.4.0 linux-x64 node-v24.20.0
 $ gchat --help [COMMAND]
 USAGE
   $ gchat COMMAND
@@ -38,6 +38,7 @@ USAGE
 
 <!-- commands -->
 * [`gchat gchat config add-token PROFILE SPACEID TOKEN`](#gchat-gchat-config-add-token-profile-spaceid-token)
+* [`gchat gchat config add-user NAME USERID`](#gchat-gchat-config-add-user-name-userid)
 * [`gchat gchat config set-key PROFILE KEY`](#gchat-gchat-config-set-key-profile-key)
 * [`gchat gchat create-message SPACEID MESSAGE`](#gchat-gchat-create-message-spaceid-message)
 * [`gchat gchat reply-message THREADNAME MESSAGE`](#gchat-gchat-reply-message-threadname-message)
@@ -62,7 +63,30 @@ EXAMPLES
   $ gchat gchat config add-token default AAQAKA6hsFw your-space-token
 ```
 
-_See code: [src/commands/gchat/config/add-token.ts](https://github.com/hesedcasa/gchat/blob/v0.3.1/src/commands/gchat/config/add-token.ts)_
+_See code: [src/commands/gchat/config/add-token.ts](https://github.com/hesedcasa/gchat/blob/v0.4.0/src/commands/gchat/config/add-token.ts)_
+
+## `gchat gchat config add-user NAME USERID`
+
+Add or update a user in the users list for tagging messages
+
+```
+USAGE
+  $ gchat gchat config add-user NAME USERID
+
+ARGUMENTS
+  NAME    Display name of the user, used with --tag
+  USERID  Google Chat user ID (e.g. users/123456789)
+
+DESCRIPTION
+  Add or update a user in the users list for tagging messages
+
+EXAMPLES
+  $ gchat gchat config add-user "Jane Doe" users/123456789012345678901
+
+  $ gchat gchat config add-user "Jane Doe" 123456789012345678901
+```
+
+_See code: [src/commands/gchat/config/add-user.ts](https://github.com/hesedcasa/gchat/blob/v0.4.0/src/commands/gchat/config/add-user.ts)_
 
 ## `gchat gchat config set-key PROFILE KEY`
 
@@ -85,7 +109,7 @@ EXAMPLES
   $ gchat gchat config set-key work your-work-api-key
 ```
 
-_See code: [src/commands/gchat/config/set-key.ts](https://github.com/hesedcasa/gchat/blob/v0.3.1/src/commands/gchat/config/set-key.ts)_
+_See code: [src/commands/gchat/config/set-key.ts](https://github.com/hesedcasa/gchat/blob/v0.4.0/src/commands/gchat/config/set-key.ts)_
 
 ## `gchat gchat create-message SPACEID MESSAGE`
 
@@ -93,7 +117,7 @@ Send a message to a Google Chat space
 
 ```
 USAGE
-  $ gchat gchat create-message SPACEID MESSAGE [-f] [-p <value>] [--toon]
+  $ gchat gchat create-message SPACEID MESSAGE [-f] [-p <value>] [-t <value>...] [--toon]
 
 ARGUMENTS
   SPACEID  Google Chat space ID
@@ -102,6 +126,7 @@ ARGUMENTS
 FLAGS
   -f, --formatted        Enable formatted text (bold, italic, links)
   -p, --profile=<value>  [default: default] Config profile to use
+  -t, --tag=<value>...   User name or users/<id> to tag (repeatable)
       --toon             Format output as toon
 
 DESCRIPTION
@@ -115,9 +140,11 @@ EXAMPLES
   $ gchat gchat create-message AAQAKA6hsFw "*Bold message*" --formatted
 
   $ gchat gchat create-message AAQAKA6hsFw "<https://example.com|Click here>" -f
+
+  $ gchat gchat create-message AAQAKA6hsFw "Deploy failed" --tag "Jane Doe"
 ```
 
-_See code: [src/commands/gchat/create-message.ts](https://github.com/hesedcasa/gchat/blob/v0.3.1/src/commands/gchat/create-message.ts)_
+_See code: [src/commands/gchat/create-message.ts](https://github.com/hesedcasa/gchat/blob/v0.4.0/src/commands/gchat/create-message.ts)_
 
 ## `gchat gchat reply-message THREADNAME MESSAGE`
 
@@ -125,7 +152,7 @@ Reply to a message thread in Google Chat
 
 ```
 USAGE
-  $ gchat gchat reply-message THREADNAME MESSAGE [-f] [-p <value>] [--toon]
+  $ gchat gchat reply-message THREADNAME MESSAGE [-f] [-p <value>] [-t <value>...] [--toon]
 
 ARGUMENTS
   THREADNAME  Thread name (e.g. spaces/SPACE_ID/threads/THREAD_ID)
@@ -134,6 +161,7 @@ ARGUMENTS
 FLAGS
   -f, --formatted        Enable formatted text (bold, italic, links)
   -p, --profile=<value>  [default: default] Config profile to use
+  -t, --tag=<value>...   User name or users/<id> to tag (repeatable)
       --toon             Format output as toon
 
 DESCRIPTION
@@ -145,7 +173,9 @@ EXAMPLES
   $ gchat gchat reply-message spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "Reply here" --profile work
 
   $ gchat gchat reply-message spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "*Bold reply*" --formatted
+
+  $ gchat gchat reply-message spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "Check this" --tag "Jane Doe"
 ```
 
-_See code: [src/commands/gchat/reply-message.ts](https://github.com/hesedcasa/gchat/blob/v0.3.1/src/commands/gchat/reply-message.ts)_
+_See code: [src/commands/gchat/reply-message.ts](https://github.com/hesedcasa/gchat/blob/v0.4.0/src/commands/gchat/reply-message.ts)_
 <!-- commandsstop -->

package/dist/commands/gchat/config/add-token.js

@@ -10,7 +10,9 @@ export default class ConfigAddToken extends Command {
     static examples = ['<%= config.bin %> <%= command.id %> default AAQAKA6hsFw your-space-token'];
     async run() {
         const { args } = await this.parse(ConfigAddToken);
-        const config = await readConfigOrEmpty(this.config.configDir);
+        const config = await readConfigOrEmpty(this.config.configDir, this.log.bind(this));
+        if (!config)
+            return;
         const profile = config.profiles[args.profile] ?? { key: '', tokens: {} };
         profile.tokens[args.spaceId] = args.token;
         config.profiles[args.profile] = profile;

package/dist/commands/gchat/config/add-user.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class ConfigAddUser extends Command {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        userId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/gchat/config/add-user.js

@@ -0,0 +1,20 @@
+import { Args, Command } from '@oclif/core';
+import { addUser } from '../../../config.js';
+export default class ConfigAddUser extends Command {
+    static args = {
+        name: Args.string({ description: 'Display name of the user, used with --tag', required: true }),
+        userId: Args.string({ description: 'Google Chat user ID (e.g. users/123456789)', required: true }),
+    };
+    static description = 'Add or update a user in the users list for tagging messages';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> "Jane Doe" users/123456789012345678901',
+        '<%= config.bin %> <%= command.id %> "Jane Doe" 123456789012345678901',
+    ];
+    async run() {
+        const { args } = await this.parse(ConfigAddUser);
+        const config = await addUser(this.config.configDir, args.name, args.userId, this.log.bind(this));
+        if (!config)
+            return;
+        this.log(`User '${args.name}' saved as ${config.users[args.name]} in the users list.`);
+    }
+}

package/dist/commands/gchat/config/set-key.js

@@ -14,7 +14,9 @@ export default class ConfigSetKey extends Command {
     ];
     async run() {
         const { args } = await this.parse(ConfigSetKey);
-        const config = await readConfigOrEmpty(this.config.configDir);
+        const config = await readConfigOrEmpty(this.config.configDir, this.log.bind(this));
+        if (!config)
+            return;
         const profile = config.profiles[args.profile] ?? { key: '', tokens: {} };
         profile.key = args.key;
         config.profiles[args.profile] = profile;

package/dist/commands/gchat/create-message.d.ts

@@ -9,6 +9,7 @@ export default class GChatCreateMessage extends Command {
     static flags: {
         formatted: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         profile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/gchat/create-message.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { DEFAULT_PROFILE, readConfig, resolveProfile } from '../../config.js';
+import { DEFAULT_PROFILE, readConfig, resolveProfile, resolveTags } from '../../config.js';
 import { formatAsToon } from '../../format.js';
 import { clearClients, newMessage } from '../../gchat/gchat-client.js';
 export default class GChatCreateMessage extends Command {
@@ -15,6 +15,7 @@ export default class GChatCreateMessage extends Command {
         '<%= config.bin %> <%= command.id %> AAQAKA6hsFw "Hello work" --profile work',
         '<%= config.bin %> <%= command.id %> AAQAKA6hsFw "*Bold message*" --formatted',
         '<%= config.bin %> <%= command.id %> AAQAKA6hsFw "<https://example.com|Click here>" -f',
+        '<%= config.bin %> <%= command.id %> AAQAKA6hsFw "Deploy failed" --tag "Jane Doe"',
     ];
     static flags = {
         formatted: Flags.boolean({ char: 'f', description: 'Enable formatted text (bold, italic, links)', required: false }),
@@ -24,6 +25,12 @@ export default class GChatCreateMessage extends Command {
             description: 'Config profile to use',
             required: false,
         }),
+        tag: Flags.string({
+            char: 't',
+            description: 'User name or users/<id> to tag (repeatable)',
+            multiple: true,
+            required: false,
+        }),
         toon: Flags.boolean({ description: 'Format output as toon', required: false }),
     };
     async run() {
@@ -34,7 +41,14 @@ export default class GChatCreateMessage extends Command {
         const auth = resolveProfile(config, flags.profile, this.log.bind(this));
         if (!auth)
             return;
-        const result = await newMessage(auth, args.spaceId, args.message.replaceAll(String.raw `\n`, '\n'), flags.formatted);
+        const tags = resolveTags(config, flags.tag ?? [], this.log.bind(this));
+        if (!tags)
+            return;
+        let message = args.message.replaceAll(String.raw `\n`, '\n');
+        for (const tag of tags) {
+            message += `\n<${tag}>`;
+        }
+        const result = await newMessage(auth, args.spaceId, message, flags.formatted);
         clearClients();
         if (flags.toon) {
             this.log(formatAsToon(result));

package/dist/commands/gchat/reply-message.d.ts

@@ -9,6 +9,7 @@ export default class GChatReplyMessage extends Command {
     static flags: {
         formatted: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         profile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/gchat/reply-message.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { DEFAULT_PROFILE, readConfig, resolveProfile } from '../../config.js';
+import { DEFAULT_PROFILE, readConfig, resolveProfile, resolveTags } from '../../config.js';
 import { formatAsToon } from '../../format.js';
 import { clearClients, replyMessage } from '../../gchat/gchat-client.js';
 export default class GChatReplyMessage extends Command {
@@ -17,6 +17,7 @@ export default class GChatReplyMessage extends Command {
         '<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "Reply here"',
         '<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "Reply here" --profile work',
         '<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "*Bold reply*" --formatted',
+        '<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA "Check this" --tag "Jane Doe"',
     ];
     static flags = {
         formatted: Flags.boolean({ char: 'f', description: 'Enable formatted text (bold, italic, links)', required: false }),
@@ -26,6 +27,12 @@ export default class GChatReplyMessage extends Command {
             description: 'Config profile to use',
             required: false,
         }),
+        tag: Flags.string({
+            char: 't',
+            description: 'User name or users/<id> to tag (repeatable)',
+            multiple: true,
+            required: false,
+        }),
         toon: Flags.boolean({ description: 'Format output as toon', required: false }),
     };
     async run() {
@@ -36,7 +43,14 @@ export default class GChatReplyMessage extends Command {
         const auth = resolveProfile(config, flags.profile, this.log.bind(this));
         if (!auth)
             return;
-        const result = await replyMessage(auth, args.threadName, args.message.replaceAll(String.raw `\n`, '\n'), flags.formatted);
+        const tags = resolveTags(config, flags.tag ?? [], this.log.bind(this));
+        if (!tags)
+            return;
+        let message = args.message.replaceAll(String.raw `\n`, '\n');
+        for (const tag of tags) {
+            message += `\n<${tag}>`;
+        }
+        const result = await replyMessage(auth, args.threadName, message, flags.formatted);
         clearClients();
         if (flags.toon) {
             this.log(formatAsToon(result));

package/dist/config.d.ts

@@ -5,8 +5,11 @@ export type GChatAuth = {
 };
 export type GChatConfig = {
     profiles: Record<string, GChatAuth>;
+    users: Record<string, string>;
 };
-export declare function readConfigOrEmpty(configDir: string): Promise<GChatConfig>;
+export declare function readConfigOrEmpty(configDir: string, log: (msg: string) => void): Promise<GChatConfig | null>;
 export declare function writeConfig(configDir: string, config: GChatConfig): Promise<void>;
 export declare function readConfig(configDir: string, log: (msg: string) => void): Promise<GChatConfig | null>;
 export declare function resolveProfile(config: GChatConfig, profile: string, log: (msg: string) => void): GChatAuth | null;
+export declare function addUser(configDir: string, name: string, userId: string, log: (msg: string) => void): Promise<GChatConfig | null>;
+export declare function resolveTags(config: GChatConfig, names: string[], log: (msg: string) => void): null | string[];

package/dist/config.js

@@ -12,26 +12,40 @@ function parseProfiles(raw) {
     // Legacy single-profile config: promote top-level key/tokens to the default profile.
     return { [DEFAULT_PROFILE]: { key: raw.key ?? '', tokens: raw.tokens ?? {} } };
 }
-export async function readConfigOrEmpty(configDir) {
+function parseUsers(raw) {
+    if (raw.users && typeof raw.users === 'object' && !Array.isArray(raw.users)) {
+        return raw.users;
+    }
+    return {};
+}
+export async function readConfigOrEmpty(configDir, log) {
     const configPath = path.join(configDir, 'gchat-config.json');
     try {
         const raw = JSON.parse(await readFile(configPath, 'utf8'));
-        return { profiles: parseProfiles(raw) };
+        return { profiles: parseProfiles(raw), users: parseUsers(raw) };
     }
-    catch {
-        return { profiles: {} };
+    catch (error) {
+        // A missing file means the user has not configured anything yet — start empty.
+        // Any other failure (malformed JSON, unreadable file) must not be treated as
+        // an empty config, or the next write would silently destroy the existing one.
+        if (error instanceof Error && error.code === 'ENOENT') {
+            return { profiles: {}, users: {} };
+        }
+        log(`Error: Could not read config from ${configPath}`);
+        log('Fix or remove the file and retry — nothing was overwritten.');
+        return null;
     }
 }
 export async function writeConfig(configDir, config) {
     const configPath = path.join(configDir, 'gchat-config.json');
     await mkdir(configDir, { recursive: true });
-    await writeFile(configPath, JSON.stringify({ profiles: config.profiles }, null, 2));
+    await writeFile(configPath, JSON.stringify({ profiles: config.profiles, users: config.users }, null, 2));
 }
 export async function readConfig(configDir, log) {
     const configPath = path.join(configDir, 'gchat-config.json');
     try {
         const raw = JSON.parse(await readFile(configPath, 'utf8'));
-        return { profiles: parseProfiles(raw) };
+        return { profiles: parseProfiles(raw), users: parseUsers(raw) };
     }
     catch {
         log(`Error: Could not read config from ${configPath}`);
@@ -47,3 +61,57 @@ export function resolveProfile(config, profile, log) {
     }
     return auth;
 }
+const USER_PREFIX = 'users/';
+function isUserId(value) {
+    if (!value.startsWith(USER_PREFIX))
+        return false;
+    const id = value.slice(USER_PREFIX.length);
+    return id.length > 0 && [...id].every((char) => char.trim().length > 0);
+}
+export async function addUser(configDir, name, userId, log) {
+    const config = await readConfigOrEmpty(configDir, log);
+    if (!config)
+        return null;
+    const normalized = userId.startsWith(USER_PREFIX) ? userId : `${USER_PREFIX}${userId}`;
+    if (!isUserId(normalized)) {
+        log(`Error: Invalid user ID '${userId}'. Expected a 'users/<id>' value with a non-empty, whitespace-free ID.`);
+        return null;
+    }
+    config.users[name] = normalized;
+    await writeConfig(configDir, config);
+    return config;
+}
+export function resolveTags(config, names, log) {
+    const resolved = [];
+    const invalid = [];
+    const unknown = [];
+    for (const name of names) {
+        // Own-property lookup only — inherited names like 'toString' must count as unknown.
+        const saved = Object.hasOwn(config.users, name) ? config.users[name] : undefined;
+        if (saved === undefined) {
+            if (isUserId(name)) {
+                resolved.push(name);
+            }
+            else {
+                unknown.push(name);
+            }
+            continue;
+        }
+        if (isUserId(saved)) {
+            resolved.push(saved);
+        }
+        else {
+            invalid.push(name);
+        }
+    }
+    if (invalid.length === 0 && unknown.length === 0)
+        return resolved;
+    for (const name of invalid) {
+        log(`Error: Saved user '${name}' has an invalid ID: '${config.users[name]}'.`);
+    }
+    for (const name of unknown) {
+        log(`Error: User '${name}' not found in the users list.`);
+    }
+    log("Run 'gchat config add-user <name> <userId>' to add or update a user.");
+    return null;
+}

package/oclif.manifest.json

@@ -19,7 +19,8 @@
         "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"Hello team\"",
         "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"Hello work\" --profile work",
         "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"*Bold message*\" --formatted",
-        "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"<https://example.com|Click here>\" -f"
+        "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"<https://example.com|Click here>\" -f",
+        "<%= config.bin %> <%= command.id %> AAQAKA6hsFw \"Deploy failed\" --tag \"Jane Doe\""
       ],
       "flags": {
         "formatted": {
@@ -40,6 +41,15 @@
           "multiple": false,
           "type": "option"
         },
+        "tag": {
+          "char": "t",
+          "description": "User name or users/<id> to tag (repeatable)",
+          "name": "tag",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "toon": {
           "description": "Format output as toon",
           "name": "toon",
@@ -82,7 +92,8 @@
       "examples": [
         "<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA \"Reply here\"",
         "<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA \"Reply here\" --profile work",
-        "<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA \"*Bold reply*\" --formatted"
+        "<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA \"*Bold reply*\" --formatted",
+        "<%= config.bin %> <%= command.id %> spaces/AAQAKA6hsFw/threads/D1NI3W2B6vA \"Check this\" --tag \"Jane Doe\""
       ],
       "flags": {
         "formatted": {
@@ -103,6 +114,15 @@
           "multiple": false,
           "type": "option"
         },
+        "tag": {
+          "char": "t",
+          "description": "User name or users/<id> to tag (repeatable)",
+          "name": "tag",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "toon": {
           "description": "Format output as toon",
           "name": "toon",
@@ -168,6 +188,43 @@
         "add-token.js"
       ]
     },
+    "gchat:config:add-user": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Display name of the user, used with --tag",
+          "name": "name",
+          "required": true
+        },
+        "userId": {
+          "description": "Google Chat user ID (e.g. users/123456789)",
+          "name": "userId",
+          "required": true
+        }
+      },
+      "description": "Add or update a user in the users list for tagging messages",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> \"Jane Doe\" users/123456789012345678901",
+        "<%= config.bin %> <%= command.id %> \"Jane Doe\" 123456789012345678901"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gchat:config:add-user",
+      "pluginAlias": "@hesed/gchat",
+      "pluginName": "@hesed/gchat",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gchat",
+        "config",
+        "add-user.js"
+      ]
+    },
     "gchat:config:set-key": {
       "aliases": [],
       "args": {
@@ -206,5 +263,5 @@
       ]
     }
   },
-  "version": "0.3.1"
+  "version": "0.4.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hesed/gchat",
   "description": "CLI for Google Chat API interaction",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "author": "Hesed",
   "bin": {
     "gchat": "./bin/run.js"
@@ -22,7 +22,7 @@
     "@types/mocha": "^10",
     "@types/node": "^26",
     "@types/sinon": "^22.0.0",
-    "c8": "^11.0.0",
+    "c8": "^12.0.0",
     "chai": "^6",
     "eslint": "^10.8.1",
     "eslint-config-oclif": "^7.1.5",