copyhub-cli 1.0.0

package/src/config.js

@@ -0,0 +1,180 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync, readFileSync } from 'node:fs';
+import { CONFIG_PATH } from './paths.js';
+import { ensureDir } from './storage.js';
+
+/**
+ * @typedef {{ clientId: string, clientSecret: string, redirectPort: number }} CopyHubConfig
+ */
+
+/** Default localhost port for OAuth browser callback. */
+export const DEFAULT_OAUTH_REDIRECT_PORT = 19999;
+
+export const ENV_GOOGLE_CLIENT_ID = 'COPYHUB_GOOGLE_CLIENT_ID';
+export const ENV_GOOGLE_CLIENT_SECRET = 'COPYHUB_GOOGLE_CLIENT_SECRET';
+export const ENV_OAUTH_REDIRECT_PORT = 'COPYHUB_OAUTH_REDIRECT_PORT';
+
+function parseRedirectPortFromEnv() {
+  const raw = process.env[ENV_OAUTH_REDIRECT_PORT]?.trim();
+  if (!raw) return null;
+  const n = parseInt(raw, 10);
+  if (!Number.isFinite(n) || n < 1 || n > 65535) return null;
+  return n;
+}
+
+/** Both Client ID and Secret come from environment (or .env). */
+export function hasOAuthCredentialsInEnv() {
+  const id = process.env[ENV_GOOGLE_CLIENT_ID]?.trim();
+  const sec = process.env[ENV_GOOGLE_CLIENT_SECRET]?.trim();
+  return Boolean(id && sec);
+}
+
+/** @returns {'env' | 'file' | 'mixed'} */
+export function describeOAuthCredentialSource() {
+  const idEnv = Boolean(process.env[ENV_GOOGLE_CLIENT_ID]?.trim());
+  const secEnv = Boolean(process.env[ENV_GOOGLE_CLIENT_SECRET]?.trim());
+  if (idEnv && secEnv) return 'env';
+  if (idEnv || secEnv) return 'mixed';
+  return 'file';
+}
+
+/** @returns {Promise<CopyHubConfig | null>} */
+export async function loadConfig() {
+  /** @type {{ clientId?: string, clientSecret?: string, redirectPort?: number }} */
+  const fromFile = {};
+
+  if (existsSync(CONFIG_PATH)) {
+    const raw = await readFile(CONFIG_PATH, 'utf8');
+    const j = JSON.parse(raw);
+    if (typeof j.clientId === 'string' && j.clientId) fromFile.clientId = j.clientId;
+    if (typeof j.clientSecret === 'string' && j.clientSecret) {
+      fromFile.clientSecret = j.clientSecret;
+    }
+    if (typeof j.redirectPort === 'number' && Number.isFinite(j.redirectPort)) {
+      fromFile.redirectPort = j.redirectPort;
+    }
+  }
+
+  const envId = process.env[ENV_GOOGLE_CLIENT_ID]?.trim();
+  const envSecret = process.env[ENV_GOOGLE_CLIENT_SECRET]?.trim();
+  const envPort = parseRedirectPortFromEnv();
+
+  const clientId = envId || fromFile.clientId;
+  const clientSecret = envSecret || fromFile.clientSecret;
+
+  const filePort =
+    typeof fromFile.redirectPort === 'number'
+      ? fromFile.redirectPort
+      : DEFAULT_OAUTH_REDIRECT_PORT;
+  const redirectPort = envPort ?? filePort;
+
+  if (!clientId || !clientSecret) return null;
+
+  return { clientId, clientSecret, redirectPort };
+}
+
+/**
+ * @typedef {{ spreadsheetId: string }} SheetSyncTarget
+ */
+
+/** @returns {Promise<SheetSyncTarget | null>} */
+export async function loadSheetSyncTarget() {
+  /** @type {{ googleSheetId?: string }} */
+  let fromFile = {};
+
+  if (existsSync(CONFIG_PATH)) {
+    try {
+      const raw = await readFile(CONFIG_PATH, 'utf8');
+      const j = JSON.parse(raw);
+      if (typeof j.googleSheetId === 'string' && j.googleSheetId.trim()) {
+        fromFile.googleSheetId = j.googleSheetId.trim();
+      }
+    } catch {
+      /* ignore */
+    }
+  }
+
+  const spreadsheetId = fromFile.googleSheetId;
+
+  if (!spreadsheetId) return null;
+  return { spreadsheetId };
+}
+
+/**
+ * Overlay shortcut (Electron Accelerator). Empty = app default.
+ * Env COPYHUB_OVERLAY_ACCELERATOR wins when set, then config.
+ */
+export function loadOverlayAcceleratorFromConfigSync() {
+  if (!existsSync(CONFIG_PATH)) return '';
+  try {
+    const j = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+    if (typeof j.overlayAccelerator === 'string') {
+      return j.overlayAccelerator.trim();
+    }
+  } catch {
+    /* ignore */
+  }
+  return '';
+}
+
+/** @returns {'win' | 'mac' | 'linux' | ''} */
+export function loadOverlayPlatformFromConfigSync() {
+  if (!existsSync(CONFIG_PATH)) return '';
+  try {
+    const j = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+    const p = typeof j.overlayPlatform === 'string' ? j.overlayPlatform.trim().toLowerCase() : '';
+    if (p === 'win' || p === 'windows') return 'win';
+    if (p === 'mac' || p === 'macos' || p === 'darwin') return 'mac';
+    if (p === 'linux') return 'linux';
+  } catch {
+    /* ignore */
+  }
+  return '';
+}
+
+/**
+ * Merge fields into ~/.copyhub/config.json (keeps existing clientId/secret).
+ * @param {Record<string, unknown>} partial
+ */
+export async function mergeConfigPartial(partial) {
+  await ensureDir();
+  /** @type {Record<string, unknown>} */
+  let existing = {};
+  if (existsSync(CONFIG_PATH)) {
+    try {
+      existing = JSON.parse(await readFile(CONFIG_PATH, 'utf8'));
+    } catch {
+      /* ignore */
+    }
+  }
+  const out = { ...existing, ...partial };
+  delete out.sheetTab;
+  delete out.sheetDailyPrefix;
+  await writeFile(CONFIG_PATH, JSON.stringify(out, null, 2), 'utf8');
+}
+
+/**
+ * @param {CopyHubConfig & { googleSheetId?: string }} cfg
+ */
+export async function saveConfig(cfg) {
+  await ensureDir();
+  /** @type {Record<string, unknown>} */
+  let existing = {};
+  if (existsSync(CONFIG_PATH)) {
+    try {
+      existing = JSON.parse(await readFile(CONFIG_PATH, 'utf8'));
+    } catch {
+      /* ignore */
+    }
+  }
+  const out = {
+    ...existing,
+    clientId: cfg.clientId,
+    clientSecret: cfg.clientSecret,
+    redirectPort: cfg.redirectPort ?? DEFAULT_OAUTH_REDIRECT_PORT,
+  };
+  if (cfg.googleSheetId !== undefined) out.googleSheetId = cfg.googleSheetId;
+  delete out.sheetTab;
+  delete out.sheetDailyPrefix;
+  await writeFile(CONFIG_PATH, JSON.stringify(out, null, 2), 'utf8');
+}

package/src/daemon-state.js

@@ -0,0 +1,51 @@
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { RUN_STATE_PATH } from './paths.js';
+
+/**
+ * @typedef {{ pid: number, startedAt: string, foreground?: boolean }} RunState
+ */
+
+/** @returns {RunState | null} */
+export function readRunState() {
+  if (!existsSync(RUN_STATE_PATH)) return null;
+  try {
+    const j = JSON.parse(readFileSync(RUN_STATE_PATH, 'utf8'));
+    if (typeof j.pid !== 'number' || !Number.isFinite(j.pid)) return null;
+    return j;
+  } catch {
+    return null;
+  }
+}
+
+/** @param {RunState} state */
+export function writeRunState(state) {
+  writeFileSync(RUN_STATE_PATH, JSON.stringify(state, null, 2), 'utf8');
+}
+
+export function clearRunState() {
+  if (!existsSync(RUN_STATE_PATH)) return;
+  try {
+    unlinkSync(RUN_STATE_PATH);
+  } catch {
+    /* ignore */
+  }
+}
+
+/** @param {number} pid */
+export function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Remove run.json when the stored PID is no longer alive (cleanup). */
+export function pruneStaleRunState() {
+  const s = readRunState();
+  if (!s) return;
+  if (!isPidAlive(s.pid)) {
+    clearRunState();
+  }
+}

package/src/electron-launcher.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+
+export function getProjectRoot() {
+  return join(dirname(fileURLToPath(import.meta.url)), '..');
+}
+
+/** Path to electron.exe (Windows) / Electron (macOS) after npm postinstall download. */
+export function resolveElectronBinary() {
+  const root = getProjectRoot();
+  const pathTxt = join(root, 'node_modules', 'electron', 'path.txt');
+  if (!fs.existsSync(pathTxt)) return null;
+  const rel = fs.readFileSync(pathTxt, 'utf8').trim();
+  const abs = join(root, 'node_modules', 'electron', rel);
+  if (!fs.existsSync(abs)) return null;
+  return abs;
+}
+
+/**
+ * Spawn the floating history overlay (Electron).
+ * @param {{ stdio?: 'inherit' | 'ignore' | 'pipe', envExtra?: Record<string, string> }} [opts]
+ */
+export function spawnCopyhubOverlay(opts = {}) {
+  const stdio = opts.stdio ?? 'inherit';
+  const root = getProjectRoot();
+  const uiMain = join(root, 'ui', 'main.mjs');
+  const env = { ...process.env, ...opts.envExtra };
+  const direct = resolveElectronBinary();
+  if (direct) {
+    return spawn(direct, [uiMain], {
+      stdio,
+      cwd: root,
+      env,
+      detached: false,
+    });
+  }
+  const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+  return spawn(npx, ['--yes', 'electron', uiMain], {
+    stdio,
+    cwd: root,
+    shell: true,
+    env,
+    detached: false,
+  });
+}