@girardmedia/bootspring 1.2.0 → 2.0.3

package/core/session.js

@@ -0,0 +1,258 @@
+/**
+ * Bootspring Session Manager
+ *
+ * Manages the current project session context linked to bootspring.com API.
+ * This tracks which project the CLI is currently working with.
+ *
+ * @package bootspring
+ * @module core/session
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const BOOTSPRING_DIR = path.join(os.homedir(), '.bootspring');
+const SESSION_FILE = path.join(BOOTSPRING_DIR, 'session.json');
+const LOCAL_CONFIG_NAME = '.bootspring.json';
+
+/**
+ * Ensure ~/.bootspring directory exists
+ */
+function ensureDir() {
+  if (!fs.existsSync(BOOTSPRING_DIR)) {
+    fs.mkdirSync(BOOTSPRING_DIR, { recursive: true, mode: 0o700 });
+  }
+}
+
+/**
+ * Get current session data
+ * @returns {object|null} Session data or null
+ */
+function getSession() {
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      return JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
+    }
+  } catch {
+    // Ignore read errors
+  }
+  return null;
+}
+
+/**
+ * Save session data
+ * @param {object} session - Session data
+ */
+function saveSession(session) {
+  ensureDir();
+  const data = {
+    ...session,
+    updatedAt: new Date().toISOString()
+  };
+  fs.writeFileSync(SESSION_FILE, JSON.stringify(data, null, 2));
+}
+
+/**
+ * Clear session
+ */
+function clearSession() {
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      fs.unlinkSync(SESSION_FILE);
+    }
+  } catch {
+    // Ignore delete errors
+  }
+}
+
+/**
+ * Get current project context
+ * @returns {object|null} Project context
+ */
+function getCurrentProject() {
+  const session = getSession();
+  return session?.project || null;
+}
+
+/**
+ * Set current project context
+ * @param {object} project - Project info { id, name, slug, ... }
+ */
+function setCurrentProject(project) {
+  const session = getSession() || {};
+  session.project = project;
+  saveSession(session);
+}
+
+/**
+ * Get recent projects
+ * @returns {Array} Recent projects
+ */
+function getRecentProjects() {
+  const session = getSession();
+  return session?.recentProjects || [];
+}
+
+/**
+ * Add to recent projects
+ * @param {object} project - Project to add
+ */
+function addRecentProject(project) {
+  const session = getSession() || {};
+  const recent = session.recentProjects || [];
+
+  // Remove if already exists
+  const filtered = recent.filter(p => p.id !== project.id);
+
+  // Add to front
+  filtered.unshift({
+    id: project.id,
+    name: project.name,
+    slug: project.slug,
+    lastUsed: new Date().toISOString()
+  });
+
+  // Keep only last 10
+  session.recentProjects = filtered.slice(0, 10);
+  saveSession(session);
+}
+
+/**
+ * Check if a local .bootspring.json or bootspring.config.js exists in cwd or ancestors
+ * @param {string} [startDir] - Starting directory
+ * @returns {object|null} Local config or null
+ */
+function findLocalConfig(startDir) {
+  let dir = startDir || process.cwd();
+
+  // Walk up to 10 directories
+  for (let i = 0; i < 10; i++) {
+    // First check for .bootspring.json
+    const jsonConfigPath = path.join(dir, LOCAL_CONFIG_NAME);
+    if (fs.existsSync(jsonConfigPath)) {
+      try {
+        const config = JSON.parse(fs.readFileSync(jsonConfigPath, 'utf-8'));
+        return {
+          ...config,
+          _path: jsonConfigPath,
+          _dir: dir
+        };
+      } catch {
+        // Continue to check other config files
+      }
+    }
+
+    // Also check for bootspring.config.js with projectId
+    const jsConfigPath = path.join(dir, 'bootspring.config.js');
+    if (fs.existsSync(jsConfigPath)) {
+      try {
+        // Clear require cache to get fresh config
+        delete require.cache[require.resolve(jsConfigPath)];
+        const config = require(jsConfigPath);
+        if (config.projectId) {
+          return {
+            projectId: config.projectId,
+            projectName: config.project?.name || config.name || 'Unknown',
+            projectSlug: config.project?.slug,
+            _path: jsConfigPath,
+            _dir: dir,
+            _fromJsConfig: true
+          };
+        }
+      } catch {
+        // Continue searching
+      }
+    }
+
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  return null;
+}
+
+/**
+ * Get effective project context (local config > session)
+ * @returns {object|null} Project context
+ */
+function getEffectiveProject() {
+  // First check for local .bootspring.json
+  const local = findLocalConfig();
+  if (local?.projectId) {
+    return {
+      id: local.projectId,
+      name: local.projectName || 'Unknown',
+      slug: local.projectSlug,
+      source: 'local',
+      _localConfig: local
+    };
+  }
+
+  // Fall back to session
+  const sessionProject = getCurrentProject();
+  if (sessionProject) {
+    return {
+      ...sessionProject,
+      source: 'session'
+    };
+  }
+
+  return null;
+}
+
+/**
+ * Create a local .bootspring.json file
+ * @param {string} dir - Directory to create in
+ * @param {object} project - Project info
+ */
+function createLocalConfig(dir, project) {
+  const configPath = path.join(dir, LOCAL_CONFIG_NAME);
+  const config = {
+    projectId: project.id,
+    projectName: project.name,
+    projectSlug: project.slug,
+    createdAt: new Date().toISOString()
+  };
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return configPath;
+}
+
+/**
+ * Get full session state for display
+ * @returns {object} Session state
+ */
+function getSessionState() {
+  const session = getSession();
+  const effective = getEffectiveProject();
+  const local = findLocalConfig();
+
+  return {
+    hasSession: !!session,
+    project: effective,
+    source: effective?.source || null,
+    hasLocalConfig: !!local,
+    localConfigPath: local?._path,
+    recentProjects: session?.recentProjects || [],
+    lastUpdated: session?.updatedAt || null
+  };
+}
+
+module.exports = {
+  BOOTSPRING_DIR,
+  SESSION_FILE,
+  LOCAL_CONFIG_NAME,
+  ensureDir,
+  getSession,
+  saveSession,
+  clearSession,
+  getCurrentProject,
+  setCurrentProject,
+  getRecentProjects,
+  addRecentProject,
+  findLocalConfig,
+  getEffectiveProject,
+  createLocalConfig,
+  getSessionState
+};