@build-astron-co/nimbus 0.4.1 → 0.4.3

package/src/state/credentials.ts

@@ -1,154 +0,0 @@
-/**
- * Auth token and device-code management helpers.
- *
- * Refactored from the auth-service database adapter
- * (services/auth-service/src/db/adapter.ts) into standalone functions
- * that operate against the unified Nimbus database.
- */
-
-import type { Database } from '../compat/sqlite';
-import { getDb } from './db';
-
-/** Row shape for the device_codes table. */
-export interface DeviceCodeRecord {
-  deviceCode: string;
-  userCode: string;
-  clientId: string | null;
-  scope: string | null;
-  status: string;
-  token: string | null;
-  expiresAt: string;
-  createdAt: string;
-}
-
-/** Row shape for the tokens table. */
-export interface TokenRecord {
-  id: string;
-  userId: string | null;
-  token: string;
-  type: string;
-  expiresAt: string | null;
-  createdAt: string;
-}
-
-// ---------------------------------------------------------------------------
-// Device Code helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Persist a new device code for the OAuth device-authorization flow.
- */
-export function saveDeviceCode(
-  deviceCode: string,
-  userCode: string,
-  expiresAt: Date,
-  clientId?: string,
-  scope?: string,
-  db?: Database
-): void {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    INSERT INTO device_codes (device_code, user_code, client_id, scope, status, expires_at)
-    VALUES (?, ?, ?, ?, 'pending', ?)
-  `);
-
-  stmt.run(deviceCode, userCode, clientId || null, scope || null, expiresAt.toISOString());
-}
-
-/**
- * Retrieve a device code record by its device_code value.
- */
-export function getDeviceCode(deviceCode: string, db?: Database): DeviceCodeRecord | null {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM device_codes WHERE device_code = ?');
-  const row: any = stmt.get(deviceCode);
-
-  if (!row) {
-    return null;
-  }
-
-  return {
-    deviceCode: row.device_code,
-    userCode: row.user_code,
-    clientId: row.client_id,
-    scope: row.scope,
-    status: row.status,
-    token: row.token,
-    expiresAt: row.expires_at,
-    createdAt: row.created_at,
-  };
-}
-
-/**
- * Update the status (and optionally the associated token) of a device code.
- */
-export function updateDeviceCodeStatus(
-  deviceCode: string,
-  status: string,
-  token?: string,
-  db?: Database
-): void {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    UPDATE device_codes
-    SET status = ?, token = COALESCE(?, token)
-    WHERE device_code = ?
-  `);
-
-  stmt.run(status, token || null, deviceCode);
-}
-
-// ---------------------------------------------------------------------------
-// Token helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Persist an authentication token.
- */
-export function saveToken(
-  id: string,
-  token: string,
-  type: string = 'access',
-  userId?: string,
-  expiresAt?: Date,
-  db?: Database
-): void {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    INSERT INTO tokens (id, user_id, token, type, expires_at)
-    VALUES (?, ?, ?, ?, ?)
-  `);
-
-  stmt.run(id, userId || null, token, type, expiresAt ? expiresAt.toISOString() : null);
-}
-
-/**
- * Retrieve a token record by its token string value.
- */
-export function getToken(token: string, db?: Database): TokenRecord | null {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM tokens WHERE token = ?');
-  const row: any = stmt.get(token);
-
-  if (!row) {
-    return null;
-  }
-
-  return {
-    id: row.id,
-    userId: row.user_id,
-    token: row.token,
-    type: row.type,
-    expiresAt: row.expires_at,
-    createdAt: row.created_at,
-  };
-}
-
-/**
- * Delete a token by its token string value.
- */
-export function deleteToken(token: string, db?: Database): void {
-  const d = db || getDb();
-  const stmt = d.prepare('DELETE FROM tokens WHERE token = ?');
-  stmt.run(token);
-}

package/src/state/db.ts

@@ -1,58 +0,0 @@
-/**
- * Database singleton for the Nimbus unified SQLite persistence layer.
- *
- * Provides a lazily-initialized, WAL-mode SQLite database stored at
- * ~/.nimbus/nimbus.db (overridable via NIMBUS_DB_PATH).  An in-memory
- * variant is available for tests.
- */
-
-import { Database } from '../compat/sqlite';
-import * as path from 'path';
-import * as os from 'os';
-import * as fs from 'fs';
-import { runMigrations } from './schema';
-
-let db: Database | null = null;
-
-/**
- * Return the shared Database instance, creating it on first call.
- * The database file lives at `~/.nimbus/nimbus.db` unless the
- * `NIMBUS_DB_PATH` environment variable points elsewhere.
- */
-export function getDb(): Database {
-  if (!db) {
-    const nimbusDir = path.join(os.homedir(), '.nimbus');
-    if (!fs.existsSync(nimbusDir)) {
-      fs.mkdirSync(nimbusDir, { recursive: true });
-    }
-    const dbPath = process.env.NIMBUS_DB_PATH || path.join(nimbusDir, 'nimbus.db');
-    db = new Database(dbPath);
-    db.exec('PRAGMA journal_mode=WAL');
-    db.exec('PRAGMA foreign_keys=ON');
-    runMigrations(db);
-  }
-  return db;
-}
-
-/**
- * Create a throwaway in-memory database for unit / integration tests.
- * Each call returns a fresh, fully-migrated instance.
- */
-export function getTestDb(): Database {
-  const testDb = new Database(':memory:');
-  testDb.exec('PRAGMA journal_mode=WAL');
-  testDb.exec('PRAGMA foreign_keys=ON');
-  runMigrations(testDb);
-  return testDb;
-}
-
-/**
- * Close the shared database connection and clear the singleton so that
- * a subsequent `getDb()` call will re-open it.
- */
-export function closeDb(): void {
-  if (db) {
-    db.close();
-    db = null;
-  }
-}

package/src/state/index.ts

@@ -1,26 +0,0 @@
-/**
- * Nimbus unified SQLite persistence layer.
- *
- * Re-exports every public symbol from the individual domain modules so that
- * consumers can do:
- *
- *   import { getDb, saveOperation, setConfig, ... } from '../state';
- */
-
-// Database lifecycle
-export { getDb, getTestDb, closeDb } from './db';
-
-// Schema / migrations
-export { runMigrations } from './schema';
-
-// Domain modules
-export * from './sessions';
-export * from './messages';
-export * from './config';
-export * from './artifacts';
-export * from './audit';
-export * from './credentials';
-export * from './teams';
-export * from './billing';
-export * from './checkpoints';
-export * from './projects';

package/src/state/messages.ts

@@ -1,115 +0,0 @@
-/**
- * Message / conversation CRUD helpers.
- *
- * Refactored from SQLiteAdapter.saveConversation, getConversation,
- * listConversations, and deleteConversation.
- */
-
-import type { Database } from '../compat/sqlite';
-import { getDb } from './db';
-
-/** Shape returned by conversation query helpers. */
-export interface ConversationRecord {
-  id: string;
-  title: string;
-  messages: any[];
-  model: string | null;
-  createdAt: string;
-  updatedAt: string;
-  metadata: any | null;
-}
-
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-
-/**
- * Persist or update a conversation.  Uses INSERT ... ON CONFLICT to upsert.
- */
-export function saveConversation(
-  id: string,
-  title: string,
-  messages: any[],
-  model?: string,
-  metadata?: any,
-  db?: Database
-): void {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    INSERT INTO conversations (id, title, messages, model, created_at, updated_at, metadata)
-    VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, ?)
-    ON CONFLICT(id) DO UPDATE SET
-      title = excluded.title,
-      messages = excluded.messages,
-      model = excluded.model,
-      updated_at = CURRENT_TIMESTAMP,
-      metadata = excluded.metadata
-  `);
-
-  stmt.run(
-    id,
-    title,
-    JSON.stringify(messages),
-    model || null,
-    metadata ? JSON.stringify(metadata) : null
-  );
-}
-
-/**
- * Retrieve a single conversation by id.
- */
-export function getConversation(id: string, db?: Database): ConversationRecord | null {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM conversations WHERE id = ?');
-  const row: any = stmt.get(id);
-
-  if (!row) {
-    return null;
-  }
-
-  return {
-    id: row.id,
-    title: row.title,
-    messages: JSON.parse(row.messages),
-    model: row.model,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
-    metadata: row.metadata ? JSON.parse(row.metadata) : null,
-  };
-}
-
-/**
- * List conversations ordered by most-recently updated first.
- */
-export function listConversations(
-  limit: number = 50,
-  offset: number = 0,
-  db?: Database
-): ConversationRecord[] {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    SELECT * FROM conversations
-    ORDER BY updated_at DESC
-    LIMIT ? OFFSET ?
-  `);
-
-  const rows: any[] = stmt.all(limit, offset) as any[];
-  return rows.map(row => ({
-    id: row.id,
-    title: row.title,
-    messages: JSON.parse(row.messages),
-    model: row.model,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
-    metadata: row.metadata ? JSON.parse(row.metadata) : null,
-  }));
-}
-
-/**
- * Delete a conversation by id.
- */
-export function deleteConversation(id: string, db?: Database): void {
-  const d = db || getDb();
-  const stmt = d.prepare('DELETE FROM conversations WHERE id = ?');
-  stmt.run(id);
-}

package/src/state/projects.ts

@@ -1,123 +0,0 @@
-/**
- * Project CRUD helpers.
- *
- * Refactored from SQLiteAdapter.saveProject, getProject, getProjectByPath,
- * listProjects, and deleteProject.
- */
-
-import type { Database } from '../compat/sqlite';
-import { getDb } from './db';
-
-/** Shape returned by project query helpers. */
-export interface ProjectRecord {
-  id: string;
-  name: string;
-  path: string;
-  config: any;
-  lastScanned: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-
-/**
- * Persist or update a project.  Uses INSERT ... ON CONFLICT to upsert.
- */
-export function saveProject(
-  id: string,
-  name: string,
-  projectPath: string,
-  config: any,
-  db?: Database
-): void {
-  const d = db || getDb();
-  const stmt = d.prepare(`
-    INSERT INTO projects (id, name, path, config, last_scanned, created_at, updated_at)
-    VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
-    ON CONFLICT(id) DO UPDATE SET
-      name = excluded.name,
-      path = excluded.path,
-      config = excluded.config,
-      last_scanned = CURRENT_TIMESTAMP,
-      updated_at = CURRENT_TIMESTAMP
-  `);
-
-  stmt.run(id, name, projectPath, JSON.stringify(config));
-}
-
-/**
- * Retrieve a project by id.
- */
-export function getProject(id: string, db?: Database): ProjectRecord | null {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM projects WHERE id = ?');
-  const row: any = stmt.get(id);
-
-  if (!row) {
-    return null;
-  }
-
-  return {
-    id: row.id,
-    name: row.name,
-    path: row.path,
-    config: JSON.parse(row.config),
-    lastScanned: row.last_scanned,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
-  };
-}
-
-/**
- * Retrieve a project by its filesystem path.
- */
-export function getProjectByPath(projectPath: string, db?: Database): ProjectRecord | null {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM projects WHERE path = ?');
-  const row: any = stmt.get(projectPath);
-
-  if (!row) {
-    return null;
-  }
-
-  return {
-    id: row.id,
-    name: row.name,
-    path: row.path,
-    config: JSON.parse(row.config),
-    lastScanned: row.last_scanned,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
-  };
-}
-
-/**
- * List all projects ordered by most-recently updated first.
- */
-export function listProjects(db?: Database): ProjectRecord[] {
-  const d = db || getDb();
-  const stmt = d.prepare('SELECT * FROM projects ORDER BY updated_at DESC');
-  const rows: any[] = stmt.all() as any[];
-
-  return rows.map(row => ({
-    id: row.id,
-    name: row.name,
-    path: row.path,
-    config: JSON.parse(row.config),
-    lastScanned: row.last_scanned,
-    createdAt: row.created_at,
-    updatedAt: row.updated_at,
-  }));
-}
-
-/**
- * Delete a project by id.
- */
-export function deleteProject(id: string, db?: Database): void {
-  const d = db || getDb();
-  const stmt = d.prepare('DELETE FROM projects WHERE id = ?');
-  stmt.run(id);
-}

package/src/state/schema.ts

@@ -1,236 +0,0 @@
-/**
- * Unified schema with all 16 tables for the Nimbus persistence layer.
- *
- * Tables cover: operations, config, templates, conversations, artifacts,
- * projects, audit_logs, safety_checks, checkpoints, device_codes, tokens,
- * teams, team_members, users, subscriptions, and usage.
- */
-
-import type { Database } from '../compat/sqlite';
-
-/**
- * Run all CREATE TABLE / CREATE INDEX migrations against the given database.
- * Every statement uses IF NOT EXISTS so the function is safe to call on an
- * already-initialised database.
- */
-export function runMigrations(db: Database): void {
-  db.exec(`
-    -- Operations / history
-    CREATE TABLE IF NOT EXISTS operations (
-      id TEXT PRIMARY KEY,
-      timestamp TEXT NOT NULL DEFAULT (datetime('now')),
-      type TEXT NOT NULL,
-      command TEXT NOT NULL,
-      input TEXT,
-      output TEXT,
-      status TEXT NOT NULL DEFAULT 'pending',
-      duration_ms INTEGER,
-      model TEXT,
-      tokens_used INTEGER,
-      cost_usd REAL,
-      metadata TEXT
-    );
-
-    -- Config key-value store
-    CREATE TABLE IF NOT EXISTS config (
-      key TEXT PRIMARY KEY,
-      value TEXT NOT NULL,
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Templates
-    CREATE TABLE IF NOT EXISTS templates (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      type TEXT NOT NULL,
-      content TEXT NOT NULL,
-      variables TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Conversations
-    CREATE TABLE IF NOT EXISTS conversations (
-      id TEXT PRIMARY KEY,
-      title TEXT NOT NULL,
-      messages TEXT NOT NULL,
-      model TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-      metadata TEXT
-    );
-
-    -- Artifacts
-    CREATE TABLE IF NOT EXISTS artifacts (
-      id TEXT PRIMARY KEY,
-      conversation_id TEXT,
-      name TEXT NOT NULL,
-      type TEXT NOT NULL,
-      content TEXT NOT NULL,
-      language TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-      metadata TEXT
-    );
-
-    -- Projects
-    CREATE TABLE IF NOT EXISTS projects (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      path TEXT NOT NULL UNIQUE,
-      config TEXT NOT NULL DEFAULT '{}',
-      last_scanned TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Audit logs
-    CREATE TABLE IF NOT EXISTS audit_logs (
-      id TEXT PRIMARY KEY,
-      timestamp TEXT NOT NULL DEFAULT (datetime('now')),
-      user_id TEXT,
-      action TEXT NOT NULL,
-      resource_type TEXT,
-      resource_id TEXT,
-      input TEXT,
-      output TEXT,
-      status TEXT NOT NULL,
-      duration_ms INTEGER,
-      metadata TEXT
-    );
-
-    -- Safety checks
-    CREATE TABLE IF NOT EXISTS safety_checks (
-      id TEXT PRIMARY KEY,
-      operation_id TEXT,
-      check_type TEXT NOT NULL,
-      check_name TEXT NOT NULL,
-      passed INTEGER NOT NULL DEFAULT 0,
-      severity TEXT,
-      message TEXT,
-      requires_approval INTEGER NOT NULL DEFAULT 0,
-      approved_by TEXT,
-      approved_at TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Checkpoints (resumable operations)
-    CREATE TABLE IF NOT EXISTS checkpoints (
-      id TEXT PRIMARY KEY,
-      operation_id TEXT NOT NULL,
-      step INTEGER NOT NULL,
-      state TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Device codes (auth)
-    CREATE TABLE IF NOT EXISTS device_codes (
-      device_code TEXT PRIMARY KEY,
-      user_code TEXT NOT NULL UNIQUE,
-      client_id TEXT,
-      scope TEXT,
-      status TEXT NOT NULL DEFAULT 'pending',
-      token TEXT,
-      expires_at TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Auth tokens
-    CREATE TABLE IF NOT EXISTS tokens (
-      id TEXT PRIMARY KEY,
-      user_id TEXT,
-      token TEXT NOT NULL UNIQUE,
-      type TEXT NOT NULL DEFAULT 'access',
-      expires_at TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Teams
-    CREATE TABLE IF NOT EXISTS teams (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      owner_id TEXT NOT NULL,
-      plan TEXT NOT NULL DEFAULT 'free',
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Team members
-    CREATE TABLE IF NOT EXISTS team_members (
-      id TEXT PRIMARY KEY,
-      team_id TEXT NOT NULL,
-      user_id TEXT NOT NULL,
-      role TEXT NOT NULL DEFAULT 'member',
-      joined_at TEXT NOT NULL DEFAULT (datetime('now')),
-      FOREIGN KEY (team_id) REFERENCES teams(id) ON DELETE CASCADE
-    );
-
-    -- Users
-    CREATE TABLE IF NOT EXISTS users (
-      id TEXT PRIMARY KEY,
-      email TEXT UNIQUE,
-      name TEXT,
-      avatar_url TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Subscriptions (billing)
-    CREATE TABLE IF NOT EXISTS subscriptions (
-      id TEXT PRIMARY KEY,
-      team_id TEXT NOT NULL,
-      plan TEXT NOT NULL DEFAULT 'free',
-      status TEXT NOT NULL DEFAULT 'active',
-      current_period_start TEXT,
-      current_period_end TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-      FOREIGN KEY (team_id) REFERENCES teams(id) ON DELETE CASCADE
-    );
-
-    -- Usage tracking (billing)
-    CREATE TABLE IF NOT EXISTS usage (
-      id TEXT PRIMARY KEY,
-      team_id TEXT,
-      user_id TEXT,
-      type TEXT NOT NULL,
-      quantity REAL NOT NULL DEFAULT 0,
-      unit TEXT NOT NULL DEFAULT 'tokens',
-      cost_usd REAL DEFAULT 0,
-      metadata TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-
-    -- Shared sessions
-    CREATE TABLE IF NOT EXISTS shares (
-      id TEXT PRIMARY KEY,
-      session_id TEXT NOT NULL,
-      name TEXT NOT NULL,
-      messages TEXT NOT NULL,
-      model TEXT,
-      mode TEXT,
-      cost_usd REAL DEFAULT 0,
-      token_count INTEGER DEFAULT 0,
-      is_live INTEGER NOT NULL DEFAULT 0,
-      write_token TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')),
-      expires_at TEXT NOT NULL
-    );
-
-    -- Indexes
-    CREATE INDEX IF NOT EXISTS idx_operations_timestamp ON operations(timestamp);
-    CREATE INDEX IF NOT EXISTS idx_operations_type ON operations(type);
-    CREATE INDEX IF NOT EXISTS idx_conversations_updated ON conversations(updated_at);
-    CREATE INDEX IF NOT EXISTS idx_artifacts_type ON artifacts(type);
-    CREATE INDEX IF NOT EXISTS idx_artifacts_conversation ON artifacts(conversation_id);
-    CREATE INDEX IF NOT EXISTS idx_audit_logs_timestamp ON audit_logs(timestamp);
-    CREATE INDEX IF NOT EXISTS idx_audit_logs_user ON audit_logs(user_id);
-    CREATE INDEX IF NOT EXISTS idx_audit_logs_action ON audit_logs(action);
-    CREATE INDEX IF NOT EXISTS idx_checkpoints_operation ON checkpoints(operation_id);
-    CREATE INDEX IF NOT EXISTS idx_team_members_team ON team_members(team_id);
-    CREATE INDEX IF NOT EXISTS idx_usage_team ON usage(team_id);
-    CREATE INDEX IF NOT EXISTS idx_usage_created ON usage(created_at);
-    CREATE INDEX IF NOT EXISTS idx_shares_session ON shares(session_id);
-    CREATE INDEX IF NOT EXISTS idx_shares_expires ON shares(expires_at);
-  `);
-}