@respan/cli 0.3.3 → 0.4.0

package/dist/lib/integrate.js

@@ -0,0 +1,153 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { Flags } from '@oclif/core';
+// ── Defaults ──────────────────────────────────────────────────────────────
+/** Default Respan API base (SaaS). Enterprise users override this. */
+export const DEFAULT_BASE_URL = 'https://api.respan.ai/api';
+// ── Shared flags ──────────────────────────────────────────────────────────
+export const integrateFlags = {
+    local: Flags.boolean({
+        description: 'Write per-project config (default)',
+        default: false,
+        exclusive: ['global'],
+    }),
+    global: Flags.boolean({
+        description: 'Write user-level global config',
+        default: false,
+        exclusive: ['local'],
+    }),
+    'project-id': Flags.string({
+        description: 'Respan project ID (added to metadata / resource attributes)',
+        env: 'RESPAN_PROJECT_ID',
+    }),
+    'base-url': Flags.string({
+        description: 'Respan API base URL (for enterprise deployments)',
+        default: DEFAULT_BASE_URL,
+    }),
+    attrs: Flags.string({
+        description: "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+        default: '{}',
+    }),
+    'dry-run': Flags.boolean({
+        description: 'Preview changes without writing files',
+        default: false,
+    }),
+};
+/**
+ * Resolve whether to write local, global, or both configs.
+ *
+ * - `--global` → 'global'
+ * - `--local`  → 'local'
+ * - neither    → tool-specific default (passed by each command)
+ */
+export function resolveScope(flags, defaultScope = 'local') {
+    if (flags.global)
+        return 'global';
+    if (flags.local)
+        return 'local';
+    return defaultScope;
+}
+/**
+ * Find the project root (git root, or cwd if not in a repo).
+ */
+export function findProjectRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+// ── Hook script ───────────────────────────────────────────────────────────
+/**
+ * Return the bundled Claude Code hook script contents.
+ *
+ * The .py file lives in src/assets/ and is copied to dist/assets/ during
+ * build.  Reading at runtime keeps the hook version-locked to the CLI
+ * version — upgrading the CLI and re-running integrate updates the hook.
+ */
+export function getHookScript() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    const hookPath = path.join(dir, '..', 'assets', 'hook.py');
+    return fs.readFileSync(hookPath, 'utf-8');
+}
+// ── Utilities ─────────────────────────────────────────────────────────────
+/**
+ * Deep merge source into target.
+ * Objects are recursively merged; arrays and primitives from source overwrite.
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sv = source[key];
+        const tv = target[key];
+        if (sv && typeof sv === 'object' && !Array.isArray(sv) &&
+            tv && typeof tv === 'object' && !Array.isArray(tv)) {
+            result[key] = deepMerge(tv, sv);
+        }
+        else {
+            result[key] = sv;
+        }
+    }
+    return result;
+}
+export function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+export function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeJsonFile(filePath, data) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+export function readTextFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+export function writeTextFile(filePath, content) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content);
+}
+export function expandHome(p) {
+    if (p.startsWith('~')) {
+        return path.join(os.homedir(), p.slice(1));
+    }
+    return p;
+}
+export function parseAttrs(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        throw new Error(`Invalid JSON for --attrs: ${raw}`);
+    }
+}
+/**
+ * Convert a Record to OTel resource attributes string.
+ * Format: key1=value1,key2=value2
+ */
+export function toOtelResourceAttrs(attrs) {
+    return Object.entries(attrs)
+        .map(([k, v]) => `${k}=${v}`)
+        .join(',');
+}