kokoirc 0.2.1 → 0.2.3

package/README.md

@@ -36,8 +36,8 @@ A modern terminal IRC client built with [OpenTUI](https://github.com/anomalyco/o
 ## Install
 
 ```bash
-git clone https://github.com/kofany/OpenIRC.git
-cd OpenIRC
+git clone https://github.com/kofany/kokoIRC.git
+cd kokoIRC
 bun install
 ```
 
@@ -74,7 +74,8 @@ address = "irc.libera.chat"
 port = 6697
 tls = true
 autoconnect = true
-channels = ["#kokoirc"]
+channels = ["#kokoirc", "#secret mykey"]   # "channel key" syntax for keyed channels
+autosendcmd = "MSG NickServ identify pass; WAIT 2000; MODE $N +i"
 # sasl_user = "mynick"
 # sasl_pass = "hunter2"
 
@@ -91,16 +92,18 @@ j = "/join"
 
 ## Commands
 
-33 built-in commands. Type `/help` for the full list, `/help <command>` for details.
+38 built-in commands. Type `/help` for the full list, `/help <command>` for details.
 
 | Category | Commands |
 |----------|----------|
 | Connection | `/connect`, `/disconnect`, `/quit`, `/server` |
 | Channel | `/join`, `/part`, `/close`, `/topic`, `/list` |
-| Messaging | `/msg`, `/me`, `/notice`, `/action`, `/slap` |
-| Moderation | `/kick`, `/ban`, `/unban`, `/kb`, `/mode` |
+| Messaging | `/msg`, `/me`, `/notice`, `/action`, `/slap`, `/wallops` |
+| Moderation | `/kick`, `/ban`, `/unban`, `/kb`, `/kill`, `/mode` |
 | Nick/Ops | `/nick`, `/op`, `/deop`, `/voice`, `/devoice` |
 | User | `/whois`, `/wii`, `/ignore`, `/unignore` |
+| Info | `/stats` |
+| Server | `/quote` (`/raw`), `/oper` |
 | Config | `/set`, `/alias`, `/unalias`, `/reload` |
 | Logging | `/log status`, `/log search <query>` |
 | Scripts | `/script load`, `/script unload`, `/script list` |

package/docs/commands/kill.md

@@ -0,0 +1,24 @@
+---
+category: Moderation
+description: Disconnect a user from the network
+---
+
+# /kill
+
+## Syntax
+
+    /kill <nick> [reason]
+
+## Description
+
+Forcefully disconnect a user from the IRC network. This is an operator-only
+command. If no reason is given, the target's nick is used as the reason.
+
+## Examples
+
+    /kill spammer Spamming is not allowed
+    /kill baduser
+
+## See Also
+
+/oper, /kick, /ban

package/docs/commands/oper.md

@@ -0,0 +1,24 @@
+---
+category: Server
+description: Authenticate as an IRC operator
+---
+
+# /oper
+
+## Syntax
+
+    /oper <name> <password>
+
+## Description
+
+Authenticate as an IRC operator. Requires valid operator credentials
+configured on the server. Once authenticated, you gain access to
+operator commands like /kill and /wallops.
+
+## Examples
+
+    /oper admin secretpass
+
+## See Also
+
+/kill, /wallops

package/docs/commands/quote.md

@@ -0,0 +1,29 @@
+---
+category: Server
+description: Send a raw IRC command
+---
+
+# /quote
+
+## Syntax
+
+    /quote <raw command>
+
+## Description
+
+Send a raw IRC command directly to the server. This is useful for
+commands not yet implemented, testing, or advanced protocol interaction.
+
+## Aliases
+
+/raw
+
+## Examples
+
+    /quote VERSION
+    /raw LUSERS
+    /quote PRIVMSG #channel :hello
+
+## See Also
+
+/stats

package/docs/commands/server.md

@@ -39,6 +39,12 @@ Add a new server to the configuration.
 - `-label=<name>` — Display name
 - `-password=<pass>` — Server password (saved to .env)
 - `-sasl=<user>:<pass>` — SASL auth (saved to .env)
+- `-autosendcmd=<cmds>` — Commands to run on connect, before autojoin (must be last flag)
+
+Autosendcmd uses erssi-style syntax: commands separated by `;`, with `WAIT <ms>`
+for delays. `$N` is replaced with your nick.
+
+    /server add libera irc.libera.chat:6697 -tls -autosendcmd=MSG NickServ identify pass; WAIT 2000; MODE $N +i
 
 ### remove
 

package/docs/commands/stats.md

@@ -0,0 +1,31 @@
+---
+category: Info
+description: Request server statistics
+---
+
+# /stats
+
+## Syntax
+
+    /stats [type] [server]
+
+## Description
+
+Request statistics from the IRC server. Common stat types include:
+
+- `u` — server uptime
+- `m` — command usage counts
+- `o` — configured operators
+- `l` — connection information
+
+If no type is given, the server may return a summary or help text.
+
+## Examples
+
+    /stats
+    /stats u
+    /stats o irc.libera.chat
+
+## See Also
+
+/quote

package/docs/commands/wallops.md

@@ -0,0 +1,24 @@
+---
+category: Messaging
+description: Send a message to all IRC operators
+---
+
+# /wallops
+
+## Syntax
+
+    /wallops <message>
+
+## Description
+
+Send a message to all connected IRC operators. This is an operator-only
+command typically used for server-wide announcements among staff.
+
+## Examples
+
+    /wallops Server maintenance in 10 minutes
+    /wallops New oper guidelines posted on the wiki
+
+## See Also
+
+/oper, /quote

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokoirc",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Terminal IRC client built with OpenTUI and React",
   "module": "src/index.tsx",
   "type": "module",

package/src/core/commands/registry.ts

@@ -411,7 +411,7 @@ export const commands: Record<string, CommandDef> = {
         const id = args[1]?.toLowerCase()
         const addrArg = args[2]
         if (!id || !addrArg) {
-          addLocalEvent(`%Zf7768eUsage: /server add <id> <address>[:<port>] [-tls] [-noauto] [-bind=<ip>] [-label=<name>] [-password=<pass>] [-sasl=<user>:<pass>]%N`)
+          addLocalEvent(`%Zf7768eUsage: /server add <id> <address>[:<port>] [-tls] [-noauto] [-bind=<ip>] [-label=<name>] [-password=<pass>] [-sasl=<user>:<pass>] [-autosendcmd=<cmds>]%N`)
           return
         }
 
@@ -435,6 +435,7 @@ export const commands: Record<string, CommandDef> = {
         let sasl_pass: string | undefined
         let label = id
         let tls_verify = true
+        let autosendcmd: string | undefined
 
         for (let i = 3; i < args.length; i++) {
           const a = args[i]
@@ -450,6 +451,11 @@ export const commands: Record<string, CommandDef> = {
             sasl_user = saslParts[0]
             sasl_pass = saslParts.slice(1).join(":")
           }
+          else if (a.startsWith("-autosendcmd=")) {
+            // Consumes rest of args since the value contains spaces
+            autosendcmd = [a.slice(13), ...args.slice(i + 1)].join(" ").replace(/^"|"$/g, "")
+            break
+          }
         }
 
         const serverConfig: ServerConfig = {
@@ -463,6 +469,7 @@ export const commands: Record<string, CommandDef> = {
           nick,
           bind_ip,
           sasl_user,
+          autosendcmd,
         }
 
         const s = useStore.getState()
@@ -1371,6 +1378,70 @@ export const commands: Record<string, CommandDef> = {
     description: "Disconnect from a server",
     usage: "/disconnect [server-id] [message]",
   },
+
+  quote: {
+    handler(args, connId) {
+      const client = getClient(connId)
+      if (!client || args.length === 0) {
+        addLocalEvent(`%Zf7768eUsage: /quote <raw command>%N`)
+        return
+      }
+      client.raw(args.join(" "))
+    },
+    aliases: ["raw"],
+    description: "Send a raw IRC command to the server",
+    usage: "/quote <raw command>",
+  },
+
+  stats: {
+    handler(args, connId) {
+      const client = getClient(connId)
+      if (!client) return
+      client.raw("STATS" + (args.length ? " " + args.join(" ") : ""))
+    },
+    description: "Request server statistics",
+    usage: "/stats [type] [server]",
+  },
+
+  oper: {
+    handler(args, connId) {
+      const client = getClient(connId)
+      if (!client || args.length < 2) {
+        addLocalEvent(`%Zf7768eUsage: /oper <name> <password>%N`)
+        return
+      }
+      client.raw(`OPER ${args[0]} ${args[1]}`)
+    },
+    description: "Authenticate as an IRC operator",
+    usage: "/oper <name> <password>",
+  },
+
+  kill: {
+    handler(args, connId) {
+      const client = getClient(connId)
+      if (!client || args.length === 0) {
+        addLocalEvent(`%Zf7768eUsage: /kill <nick> [reason]%N`)
+        return
+      }
+      const reason = args.slice(1).join(" ") || args[0]
+      client.raw(`KILL ${args[0]} :${reason}`)
+    },
+    description: "Disconnect a user from the network (oper only)",
+    usage: "/kill <nick> [reason]",
+  },
+
+  wallops: {
+    handler(args, connId) {
+      const client = getClient(connId)
+      if (!client || args.length === 0) {
+        addLocalEvent(`%Zf7768eUsage: /wallops <message>%N`)
+        return
+      }
+      client.raw(`WALLOPS :${args.join(" ")}`)
+    },
+    description: "Send a message to all opers (oper only)",
+    usage: "/wallops <message>",
+  },
 }
 
 // ─── Built-in Alias Resolution ────────────────────────────────

package/src/core/config/loader.ts

@@ -80,6 +80,22 @@ export async function loadConfig(configPath: string): Promise<AppConfig> {
   const text = await file.text()
   const parsed = parseTOML(text)
   const config = mergeWithDefaults(parsed)
+
+  // Load ~/.kokoirc/.env into process.env (Bun only auto-loads cwd/.env)
+  const envFile = Bun.file(ENV_PATH)
+  if (await envFile.exists()) {
+    const envText = await envFile.text()
+    for (const line of envText.split("\n")) {
+      const trimmed = line.trim()
+      if (!trimmed || trimmed.startsWith("#")) continue
+      const eqIdx = trimmed.indexOf("=")
+      if (eqIdx === -1) continue
+      const key = trimmed.slice(0, eqIdx).trim()
+      const value = trimmed.slice(eqIdx + 1).trim()
+      if (key) process.env[key] = value
+    }
+  }
+
   config.servers = loadCredentials(config.servers, process.env)
   return config
 }
@@ -104,6 +120,7 @@ function cleanServerForTOML(server: ServerConfig): Record<string, any> {
   if (server.auto_reconnect === false) obj.auto_reconnect = false
   if (server.reconnect_delay && server.reconnect_delay !== 30) obj.reconnect_delay = server.reconnect_delay
   if (server.reconnect_max_retries != null) obj.reconnect_max_retries = server.reconnect_max_retries
+  if (server.autosendcmd) obj.autosendcmd = server.autosendcmd
   // SASL and password stored in config only if NOT in .env — sasl_user kept, pass stripped
   if (server.sasl_user) obj.sasl_user = server.sasl_user
   // password and sasl_pass NOT saved to TOML — they go to .env

package/src/core/irc/events.ts

@@ -7,6 +7,8 @@ import { handleNetsplitQuit, handleNetsplitJoin, destroyNetsplitState } from "./
 import { shouldSuppressNickFlood, destroyAntifloodState } from "./antiflood"
 import { shouldIgnore } from "./ignore"
 import { eventBus } from "@/core/scripts/event-bus"
+import { parseCommand } from "@/core/commands/parser"
+import { executeCommand } from "@/core/commands/execution"
 
 function isChannelTarget(target: string): boolean {
   return target.startsWith("#") || target.startsWith("&") || target.startsWith("+") || target.startsWith("!")
@@ -53,15 +55,18 @@ export function bindEvents(client: Client, connectionId: string) {
     const s = getStore()
     s.updateConnection(connectionId, { status: "connected", nick: event.nick })
     statusMsg(`%Z9ece6aRegistered as %Zc0caf5${event.nick}%N`)
-    // Auto-join channels from config
     const config = s.config
-    if (config) {
-      const serverConfig = Object.entries(config.servers).find(([id]) => id === connectionId)?.[1]
-      if (serverConfig) {
-        for (const channel of serverConfig.channels) {
-          client.join(channel)
-        }
-      }
+    const serverConfig = config
+      ? Object.entries(config.servers).find(([id]) => id === connectionId)?.[1]
+      : undefined
+
+    // Execute autosendcmd before autojoin (erssi-style: ";"-separated, WAIT <ms> for delays)
+    if (serverConfig?.autosendcmd) {
+      runAutosendcmd(serverConfig.autosendcmd, connectionId, event.nick, () => {
+        autojoinChannels(client, serverConfig)
+      })
+    } else {
+      if (serverConfig) autojoinChannels(client, serverConfig)
     }
   })
 
@@ -1029,3 +1034,51 @@ function makeFormattedEvent(key: string, params: string[]): Message {
   }
 }
 
+// ─── Autosendcmd ─────────────────────────────────────────
+
+/** Join channels from config, supporting "channel key" syntax. */
+function autojoinChannels(client: Client, serverConfig: import("@/types/config").ServerConfig) {
+  for (const entry of serverConfig.channels) {
+    const spaceIdx = entry.indexOf(" ")
+    if (spaceIdx === -1) {
+      client.join(entry)
+    } else {
+      client.join(entry.slice(0, spaceIdx), entry.slice(spaceIdx + 1))
+    }
+  }
+}
+
+/**
+ * Execute autosendcmd string (erssi-style: ";"-separated commands, WAIT <ms> for delays).
+ * Substitutes $N with current nick. Calls onDone() when all commands (including WAITs) complete.
+ */
+function runAutosendcmd(cmd: string, connectionId: string, nick: string, onDone: () => void) {
+  const parts = cmd.split(";").map((p) => p.trim()).filter(Boolean)
+  let i = 0
+
+  function next() {
+    while (i < parts.length) {
+      const part = parts[i++]
+      // Variable substitution ($N = nick)
+      const expanded = part.replace(/\$\{?N\}?/g, nick)
+
+      // WAIT <ms> — delay before next command
+      const waitMatch = expanded.match(/^WAIT\s+(\d+)$/i)
+      if (waitMatch) {
+        setTimeout(next, parseInt(waitMatch[1], 10))
+        return
+      }
+
+      // Treat as command: prepend / if missing, parse and execute
+      const line = expanded.startsWith("/") ? expanded : "/" + expanded
+      const parsed = parseCommand(line)
+      if (parsed) {
+        executeCommand(parsed, connectionId)
+      }
+    }
+    onDone()
+  }
+
+  next()
+}
+

package/src/types/config.ts

@@ -123,4 +123,5 @@ export interface ServerConfig {
   auto_reconnect?: boolean    // auto reconnect on disconnect (default: true)
   reconnect_delay?: number    // seconds between reconnect attempts (default: 30)
   reconnect_max_retries?: number // max reconnect attempts (default: 10)
+  autosendcmd?: string        // commands to run on connect, before autojoin (;-separated, WAIT <ms> for delays)
 }