service-setup-cokacdir 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 코드깎는노인
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# service-setup-cokacdir
+
+[cokacdir](https://cokacdir.cokac.com) 텔레그램 봇 서버를 **명령어 한 줄**로 시스템 서비스에 등록합니다.
+
+- Linux, macOS 자동 감지
+- `sudo` 불필요
+- 서버 재부팅 시 자동 시작
+- 죽어도 자동 재시작
+- 토큰 변경 시 같은 명령어로 업데이트
+
+## 설치 & 실행
+
+```bash
+npx -y service-setup-cokacdir <봇토큰>
+```
+
+토큰 여러 개도 가능합니다.
+
+```bash
+npx -y service-setup-cokacdir <봇토큰1> <봇토큰2> <봇토큰3>
+```
+
+이게 끝입니다. OS를 자동 감지하여 서비스가 바로 시작됩니다.
+
+## 토큰 변경
+
+같은 명령어를 다시 실행하면 됩니다. 기존 서비스를 자동으로 멈추고 새 설정으로 재시작합니다.
+
+```bash
+npx -y service-setup-cokacdir <새로운토큰1> <새로운토큰2>
+```
+
+## 서비스 관리
+
+### Linux
+
+```bash
+# 상태 확인
+systemctl --user status cokacdir
+
+# 로그 보기
+tail -f ~/.local/log/cokacdir.log
+
+# 중지
+systemctl --user stop cokacdir
+
+# 완전 삭제
+systemctl --user disable cokacdir && rm ~/.config/systemd/user/cokacdir.service
+```
+
+### macOS
+
+```bash
+# 상태 확인
+launchctl list | grep com.cokacdir.server
+
+# 로그 보기
+tail -f ~/.local/log/cokacdir.log
+
+# 중지
+launchctl unload ~/Library/LaunchAgents/com.cokacdir.server.plist
+
+# 완전 삭제
+launchctl unload ~/Library/LaunchAgents/com.cokacdir.server.plist && rm ~/Library/LaunchAgents/com.cokacdir.server.plist
+```
+
+## 동작 원리
+
+이 명령어를 실행하면 OS를 자동 감지하여 아래 과정이 수행됩니다.
+
+| | Linux | macOS |
+|--|--|--|
+| 서비스 파일 | `~/.config/systemd/user/cokacdir.service` | `~/Library/LaunchAgents/com.cokacdir.server.plist` |
+| 등록 명령 | `systemctl --user enable & start` | `launchctl load` |
+| 자동 재시작 | `Restart=always` | `KeepAlive=true` |
+| 부팅 시 시작 | `loginctl enable-linger` | `RunAtLoad=true` |
+
+## 요구사항
+
+- Linux (systemd) 또는 macOS
+- [cokacdir](https://cokacdir.cokac.com) 설치 완료
+- Node.js >= 14
+
+## License
+
+MIT

package/bin/setup.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+// --- 인자 파싱 ---
+const tokens = process.argv.slice(2);
+
+if (tokens.length === 0) {
+  console.error("Usage: npx service-setup-cokacdir <BOT_TOKEN> [BOT_TOKEN2] ...");
+  process.exit(1);
+}
+
+// --- cokacdir 바이너리 찾기 ---
+let binaryPath;
+try {
+  binaryPath = execSync("which cokacdir", { encoding: "utf-8" }).trim();
+} catch {
+  console.error("Error: cokacdir not found in PATH.");
+  console.error("Install cokacdir first, then retry.");
+  process.exit(1);
+}
+
+const platform = os.platform();
+const serviceName = "cokacdir";
+const homeDir = os.homedir();
+const tokensArg = tokens.join(" ");
+
+function escapeXml(str) {
+  return str
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}
+
+if (platform === "linux") {
+  setupLinux();
+} else if (platform === "darwin") {
+  setupMacOS();
+} else {
+  console.error(`Unsupported platform: ${platform}`);
+  console.error("This tool supports Linux and macOS only.");
+  process.exit(1);
+}
+
+// ============================================================
+//  Linux — systemd user service
+// ============================================================
+function setupLinux() {
+  const serviceDir = path.join(homeDir, ".config", "systemd", "user");
+  const serviceFile = path.join(serviceDir, `${serviceName}.service`);
+  const logDir = path.join(homeDir, ".local", "log");
+
+  const serviceContent = `[Unit]
+Description=Cokacdir Server Service
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${binaryPath} --ccserver ${tokensArg}
+Restart=always
+RestartSec=5
+StandardOutput=append:${logDir}/cokacdir.log
+StandardError=append:${logDir}/cokacdir.error.log
+
+[Install]
+WantedBy=default.target
+`;
+
+  fs.mkdirSync(serviceDir, { recursive: true });
+  fs.mkdirSync(logDir, { recursive: true });
+
+  // 기존 서비스 확인 및 중지
+  const isUpdate = fs.existsSync(serviceFile);
+  if (isUpdate) {
+    console.log("Existing service found. Stopping for update...");
+    try {
+      execSync(`systemctl --user stop ${serviceName}`, { stdio: "inherit" });
+    } catch {
+      // 이미 멈춰있을 수 있음
+    }
+  }
+
+  fs.writeFileSync(serviceFile, serviceContent, { mode: 0o644 });
+  console.log(
+    isUpdate
+      ? `Service file updated: ${serviceFile}`
+      : `Service file created: ${serviceFile}`
+  );
+
+  try {
+    execSync("systemctl --user daemon-reload", { stdio: "inherit" });
+    execSync(`systemctl --user enable ${serviceName}`, { stdio: "inherit" });
+    execSync(`systemctl --user restart ${serviceName}`, { stdio: "inherit" });
+  } catch (err) {
+    console.error("Failed to register systemd user service:", err.message);
+    process.exit(1);
+  }
+
+  try {
+    execSync(`loginctl enable-linger ${os.userInfo().username}`, {
+      stdio: "inherit",
+    });
+    console.log("Linger enabled: service will start on boot.");
+  } catch {
+    console.log(
+      "Warning: could not enable linger. Service may not auto-start on boot."
+    );
+    console.log(
+      `Run manually: loginctl enable-linger ${os.userInfo().username}`
+    );
+  }
+
+  console.log("\n------------------------------------------------");
+  console.log("Setup complete!");
+  console.log(`Status : systemctl --user status ${serviceName}`);
+  console.log(`Logs   : tail -f ${logDir}/cokacdir.log`);
+  console.log(`Stop   : systemctl --user stop ${serviceName}`);
+  console.log(`Remove : systemctl --user disable ${serviceName} && rm ${serviceFile}`);
+  console.log("------------------------------------------------");
+}
+
+// ============================================================
+//  macOS — launchd LaunchAgents
+// ============================================================
+function setupMacOS() {
+  const agentDir = path.join(homeDir, "Library", "LaunchAgents");
+  const label = `com.cokacdir.server`;
+  const plistFile = path.join(agentDir, `${label}.plist`);
+  const logDir = path.join(homeDir, ".local", "log");
+
+  const programArgs = [binaryPath, "--ccserver", ...tokens];
+  const argsXml = programArgs
+    .map((arg) => `        <string>${escapeXml(arg)}</string>`)
+    .join("\n");
+
+  const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${label}</string>
+    <key>ProgramArguments</key>
+    <array>
+${argsXml}
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${logDir}/cokacdir.log</string>
+    <key>StandardErrorPath</key>
+    <string>${logDir}/cokacdir.error.log</string>
+</dict>
+</plist>
+`;
+
+  fs.mkdirSync(agentDir, { recursive: true });
+  fs.mkdirSync(logDir, { recursive: true });
+
+  const uid = process.getuid();
+  const domain = `gui/${uid}`;
+
+  // 기존 서비스 확인 및 중지
+  const isUpdate = fs.existsSync(plistFile);
+  if (isUpdate) {
+    console.log("Existing service found. Stopping for update...");
+    try {
+      execSync(`launchctl bootout ${domain}/${label}`, { stdio: "inherit" });
+    } catch {
+      try {
+        execSync(`launchctl unload ${plistFile}`, { stdio: "inherit" });
+      } catch {
+        // 이미 멈춰있을 수 있음
+      }
+    }
+  }
+
+  fs.writeFileSync(plistFile, plistContent, { mode: 0o644 });
+  console.log(
+    isUpdate
+      ? `Plist file updated: ${plistFile}`
+      : `Plist file created: ${plistFile}`
+  );
+
+  try {
+    execSync(`launchctl bootstrap ${domain} ${plistFile}`, { stdio: "inherit" });
+  } catch {
+    try {
+      execSync(`launchctl load ${plistFile}`, { stdio: "inherit" });
+    } catch (err) {
+      console.error("Failed to register launchd service:", err.message);
+      process.exit(1);
+    }
+  }
+
+  console.log("\n------------------------------------------------");
+  console.log("Setup complete!");
+  console.log(`Status : launchctl list | grep ${label}`);
+  console.log(`Logs   : tail -f ${logDir}/cokacdir.log`);
+  console.log(`Stop   : launchctl unload ${plistFile}`);
+  console.log(`Remove : launchctl unload ${plistFile} && rm ${plistFile}`);
+  console.log("------------------------------------------------");
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "service-setup-cokacdir",
+  "version": "1.0.0",
+  "description": "Register cokacdir as a system service with a single command (Linux & macOS)",
+  "bin": {
+    "service-setup-cokacdir": "./bin/setup.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "cokacdir",
+    "systemd",
+    "service",
+    "telegram",
+    "bot",
+    "daemon",
+    "launchd",
+    "macos"
+  ],
+  "author": {
+    "name": "코드깎는노인",
+    "email": "monogatree@gmail.com",
+    "url": "https://cokacdir.cokac.com"
+  },
+  "homepage": "https://cokacdir.cokac.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/monogatree/service-setup-cokacdir"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "os": [
+    "linux",
+    "darwin"
+  ]
+}