@hasna/contacts 0.1.0

package/dist/index.js

@@ -0,0 +1,999 @@
+// @bun
+// src/db/database.ts
+import { Database } from "bun:sqlite";
+import { existsSync, mkdirSync } from "fs";
+import { dirname, join, resolve } from "path";
+function getDbPath() {
+  if (process.env["CONTACTS_DB_PATH"])
+    return process.env["CONTACTS_DB_PATH"];
+  const home = process.env["HOME"] || "~";
+  return join(home, ".contacts", "contacts.db");
+}
+function ensureDir(filePath) {
+  if (filePath === ":memory:")
+    return;
+  const dir = dirname(resolve(filePath));
+  if (!existsSync(dir))
+    mkdirSync(dir, { recursive: true });
+}
+var MIGRATIONS = [
+  `
+  CREATE TABLE IF NOT EXISTS companies (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    domain TEXT,
+    logo_url TEXT,
+    description TEXT,
+    industry TEXT,
+    size TEXT,
+    founded_year INTEGER,
+    notes TEXT,
+    custom_fields TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS contacts (
+    id TEXT PRIMARY KEY,
+    first_name TEXT NOT NULL DEFAULT '',
+    last_name TEXT NOT NULL DEFAULT '',
+    display_name TEXT NOT NULL,
+    nickname TEXT,
+    avatar_url TEXT,
+    notes TEXT,
+    birthday TEXT,
+    company_id TEXT REFERENCES companies(id) ON DELETE SET NULL,
+    job_title TEXT,
+    source TEXT NOT NULL DEFAULT 'manual',
+    custom_fields TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS tags (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    color TEXT NOT NULL DEFAULT '#6366f1',
+    description TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS contact_tags (
+    contact_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
+    tag_id TEXT NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
+    PRIMARY KEY (contact_id, tag_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS company_tags (
+    company_id TEXT NOT NULL REFERENCES companies(id) ON DELETE CASCADE,
+    tag_id TEXT NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
+    PRIMARY KEY (company_id, tag_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS emails (
+    id TEXT PRIMARY KEY,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE CASCADE,
+    company_id TEXT REFERENCES companies(id) ON DELETE CASCADE,
+    address TEXT NOT NULL,
+    type TEXT NOT NULL DEFAULT 'work' CHECK(type IN ('work','personal','other')),
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS phones (
+    id TEXT PRIMARY KEY,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE CASCADE,
+    company_id TEXT REFERENCES companies(id) ON DELETE CASCADE,
+    number TEXT NOT NULL,
+    country_code TEXT,
+    type TEXT NOT NULL DEFAULT 'mobile' CHECK(type IN ('mobile','work','home','fax','whatsapp','other')),
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS addresses (
+    id TEXT PRIMARY KEY,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE CASCADE,
+    company_id TEXT REFERENCES companies(id) ON DELETE CASCADE,
+    type TEXT NOT NULL DEFAULT 'physical' CHECK(type IN ('physical','mailing','billing','virtual','other')),
+    street TEXT,
+    city TEXT,
+    state TEXT,
+    zip TEXT,
+    country TEXT,
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS social_profiles (
+    id TEXT PRIMARY KEY,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE CASCADE,
+    company_id TEXT REFERENCES companies(id) ON DELETE CASCADE,
+    platform TEXT NOT NULL CHECK(platform IN ('twitter','linkedin','github','instagram','telegram','discord','youtube','tiktok','bluesky','facebook','whatsapp','snapchat','reddit','other')),
+    handle TEXT,
+    url TEXT,
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS contact_relationships (
+    id TEXT PRIMARY KEY,
+    contact_a_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
+    contact_b_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
+    relationship_type TEXT NOT NULL CHECK(relationship_type IN ('colleague','friend','family','reports_to','mentor','investor','partner','client','vendor','other')),
+    notes TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS activity_log (
+    id TEXT PRIMARY KEY,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE CASCADE,
+    company_id TEXT REFERENCES companies(id) ON DELETE CASCADE,
+    action TEXT NOT NULL,
+    details TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS webhooks (
+    id TEXT PRIMARY KEY,
+    url TEXT NOT NULL,
+    events TEXT NOT NULL DEFAULT '["*"]',
+    secret TEXT,
+    active INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS contacts_fts USING fts5(
+    id UNINDEXED,
+    display_name,
+    first_name,
+    last_name,
+    nickname,
+    notes,
+    job_title,
+    content='contacts',
+    content_rowid='rowid'
+  );
+
+  CREATE TRIGGER IF NOT EXISTS contacts_fts_insert AFTER INSERT ON contacts BEGIN
+    INSERT INTO contacts_fts(rowid, id, display_name, first_name, last_name, nickname, notes, job_title)
+    VALUES (new.rowid, new.id, new.display_name, new.first_name, new.last_name, new.nickname, new.notes, new.job_title);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS contacts_fts_update AFTER UPDATE ON contacts BEGIN
+    DELETE FROM contacts_fts WHERE rowid = old.rowid;
+    INSERT INTO contacts_fts(rowid, id, display_name, first_name, last_name, nickname, notes, job_title)
+    VALUES (new.rowid, new.id, new.display_name, new.first_name, new.last_name, new.nickname, new.notes, new.job_title);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS contacts_fts_delete AFTER DELETE ON contacts BEGIN
+    DELETE FROM contacts_fts WHERE rowid = old.rowid;
+  END;
+
+  CREATE TABLE IF NOT EXISTS _migrations (version INTEGER PRIMARY KEY);
+  `
+];
+var _db = null;
+function getDatabase(path) {
+  if (_db)
+    return _db;
+  const dbPath = path || getDbPath();
+  ensureDir(dbPath);
+  const db = new Database(dbPath, { create: true });
+  db.exec("PRAGMA journal_mode=WAL");
+  db.exec("PRAGMA foreign_keys=ON");
+  runMigrations(db);
+  _db = db;
+  return db;
+}
+function resetDatabase() {
+  _db = null;
+}
+function uuid() {
+  return crypto.randomUUID();
+}
+function now() {
+  return new Date().toISOString();
+}
+function runMigrations(db) {
+  try {
+    const row = db.query("SELECT MAX(version) as v FROM _migrations").get();
+    const current = row?.v ?? -1;
+    for (let i = current + 1;i < MIGRATIONS.length; i++) {
+      db.exec(MIGRATIONS[i]);
+      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${i})`);
+    }
+  } catch {
+    for (const m of MIGRATIONS) {
+      try {
+        db.exec(m);
+      } catch {}
+    }
+    try {
+      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${MIGRATIONS.length - 1})`);
+    } catch {}
+  }
+}
+// src/types/index.ts
+class ContactNotFoundError extends Error {
+  constructor(id) {
+    super(`Contact not found: ${id}`);
+    this.name = "ContactNotFoundError";
+  }
+}
+
+class CompanyNotFoundError extends Error {
+  constructor(id) {
+    super(`Company not found: ${id}`);
+    this.name = "CompanyNotFoundError";
+  }
+}
+
+class TagNotFoundError extends Error {
+  constructor(id) {
+    super(`Tag not found: ${id}`);
+    this.name = "TagNotFoundError";
+  }
+}
+
+class DuplicateTagNameError extends Error {
+  constructor(name) {
+    super(`Tag with name already exists: ${name}`);
+    this.name = "DuplicateTagNameError";
+  }
+}
+
+// src/db/activity.ts
+function rowToActivity(row) {
+  return { ...row };
+}
+function logActivity(db, input) {
+  const id = uuid();
+  db.run(`INSERT INTO activity_log (id, contact_id, company_id, action, details) VALUES (?, ?, ?, ?, ?)`, [id, input.contact_id ?? null, input.company_id ?? null, input.action, input.details ?? null]);
+  return db.query(`SELECT * FROM activity_log WHERE id = ?`).get(id);
+}
+function listActivity(opts = {}, db) {
+  const d = db || getDatabase();
+  const { limit = 50, offset = 0, contact_id, company_id } = opts;
+  const conditions = [];
+  const params = [];
+  if (contact_id) {
+    conditions.push("contact_id = ?");
+    params.push(contact_id);
+  }
+  if (company_id) {
+    conditions.push("company_id = ?");
+    params.push(company_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const totalRow = d.query(`SELECT COUNT(*) as total FROM activity_log ${where}`).get(...params);
+  const rows = d.query(`SELECT * FROM activity_log ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  return { entries: rows.map(rowToActivity), total: totalRow.total };
+}
+function getActivity(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM activity_log WHERE id = ?`).get(id);
+  return row ? rowToActivity(row) : null;
+}
+
+// src/db/contacts.ts
+function rowToContact(row) {
+  return {
+    ...row,
+    source: row.source,
+    custom_fields: JSON.parse(row.custom_fields || "{}")
+  };
+}
+function rowToEmail(row) {
+  return {
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  };
+}
+function rowToPhone(row) {
+  return {
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  };
+}
+function rowToAddress(row) {
+  return {
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  };
+}
+function rowToSocialProfile(row) {
+  return {
+    ...row,
+    platform: row.platform,
+    is_primary: !!row.is_primary
+  };
+}
+function rowToTag(row) {
+  return { ...row };
+}
+function rowToCompany(row) {
+  return {
+    ...row,
+    custom_fields: JSON.parse(row.custom_fields || "{}")
+  };
+}
+function insertEmails(db, contactId, companyId, emails) {
+  for (const e of emails) {
+    db.run(`INSERT INTO emails (id, contact_id, company_id, address, type, is_primary) VALUES (?, ?, ?, ?, ?, ?)`, [uuid(), contactId, companyId, e.address, e.type ?? "work", e.is_primary ? 1 : 0]);
+  }
+}
+function insertPhones(db, contactId, companyId, phones) {
+  for (const p of phones) {
+    db.run(`INSERT INTO phones (id, contact_id, company_id, number, country_code, type, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?)`, [uuid(), contactId, companyId, p.number, p.country_code ?? null, p.type ?? "mobile", p.is_primary ? 1 : 0]);
+  }
+}
+function insertAddresses(db, contactId, companyId, addresses) {
+  for (const a of addresses) {
+    db.run(`INSERT INTO addresses (id, contact_id, company_id, type, street, city, state, zip, country, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [uuid(), contactId, companyId, a.type ?? "physical", a.street ?? null, a.city ?? null, a.state ?? null, a.zip ?? null, a.country ?? null, a.is_primary ? 1 : 0]);
+  }
+}
+function insertSocialProfiles(db, contactId, companyId, profiles) {
+  for (const s of profiles) {
+    db.run(`INSERT INTO social_profiles (id, contact_id, company_id, platform, handle, url, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?)`, [uuid(), contactId, companyId, s.platform, s.handle ?? null, s.url ?? null, s.is_primary ? 1 : 0]);
+  }
+}
+function loadContactDetails(db, contact) {
+  const emails = db.query(`SELECT * FROM emails WHERE contact_id = ?`).all(contact.id).map(rowToEmail);
+  const phones = db.query(`SELECT * FROM phones WHERE contact_id = ?`).all(contact.id).map(rowToPhone);
+  const addresses = db.query(`SELECT * FROM addresses WHERE contact_id = ?`).all(contact.id).map(rowToAddress);
+  const social_profiles = db.query(`SELECT * FROM social_profiles WHERE contact_id = ?`).all(contact.id).map(rowToSocialProfile);
+  const tags = db.query(`
+    SELECT t.* FROM tags t
+    JOIN contact_tags ct ON ct.tag_id = t.id
+    WHERE ct.contact_id = ?
+  `).all(contact.id).map(rowToTag);
+  const companyRow = contact.company_id ? db.query(`SELECT * FROM companies WHERE id = ?`).get(contact.company_id) : null;
+  const company = companyRow ? rowToCompany(companyRow) : null;
+  return { ...contact, emails, phones, addresses, social_profiles, tags, company };
+}
+function createContact(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  const firstName = input.first_name ?? "";
+  const lastName = input.last_name ?? "";
+  const displayName = input.display_name ?? (firstName || lastName ? `${firstName} ${lastName}`.trim() : "Unnamed Contact");
+  d.run(`INSERT INTO contacts (id, first_name, last_name, display_name, nickname, avatar_url, notes, birthday, company_id, job_title, source, custom_fields, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    firstName,
+    lastName,
+    displayName,
+    input.nickname ?? null,
+    input.avatar_url ?? null,
+    input.notes ?? null,
+    input.birthday ?? null,
+    input.company_id ?? null,
+    input.job_title ?? null,
+    input.source ?? "manual",
+    JSON.stringify(input.custom_fields ?? {}),
+    timestamp,
+    timestamp
+  ]);
+  if (input.emails?.length)
+    insertEmails(d, id, null, input.emails);
+  if (input.phones?.length)
+    insertPhones(d, id, null, input.phones);
+  if (input.addresses?.length)
+    insertAddresses(d, id, null, input.addresses);
+  if (input.social_profiles?.length)
+    insertSocialProfiles(d, id, null, input.social_profiles);
+  if (input.tag_ids?.length) {
+    for (const tagId of input.tag_ids) {
+      d.run(`INSERT OR IGNORE INTO contact_tags (contact_id, tag_id) VALUES (?, ?)`, [id, tagId]);
+    }
+  }
+  logActivity(d, { contact_id: id, action: "contact.created", details: `Created contact: ${displayName}` });
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  return loadContactDetails(d, rowToContact(row));
+}
+function getContact(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  if (!row)
+    throw new ContactNotFoundError(id);
+  return loadContactDetails(d, rowToContact(row));
+}
+function listContacts(opts = {}, db) {
+  const d = db || getDatabase();
+  const {
+    limit = 50,
+    offset = 0,
+    company_id,
+    tag_id,
+    source,
+    order_by = "display_name",
+    order_dir = "asc"
+  } = opts;
+  const conditions = [];
+  const params = [];
+  if (company_id) {
+    conditions.push("c.company_id = ?");
+    params.push(company_id);
+  }
+  if (source) {
+    conditions.push("c.source = ?");
+    params.push(source);
+  }
+  if (tag_id) {
+    conditions.push("EXISTS (SELECT 1 FROM contact_tags ct WHERE ct.contact_id = c.id AND ct.tag_id = ?)");
+    params.push(tag_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const validOrderBy = ["display_name", "created_at", "updated_at"].includes(order_by) ? order_by : "display_name";
+  const validOrderDir = order_dir === "desc" ? "DESC" : "ASC";
+  const totalRow = d.query(`SELECT COUNT(*) as total FROM contacts c ${where}`).get(...params);
+  const rows = d.query(`SELECT c.* FROM contacts c ${where} ORDER BY c.${validOrderBy} ${validOrderDir} LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  const contacts = rows.map((row) => loadContactDetails(d, rowToContact(row)));
+  return { contacts, total: totalRow.total };
+}
+function updateContact(id, input, db) {
+  const d = db || getDatabase();
+  const existing = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  if (!existing)
+    throw new ContactNotFoundError(id);
+  const setClauses = ["updated_at = ?"];
+  const params = [now()];
+  if (input.first_name !== undefined) {
+    setClauses.push("first_name = ?");
+    params.push(input.first_name);
+  }
+  if (input.last_name !== undefined) {
+    setClauses.push("last_name = ?");
+    params.push(input.last_name);
+  }
+  if (input.display_name !== undefined) {
+    setClauses.push("display_name = ?");
+    params.push(input.display_name);
+  }
+  if (input.nickname !== undefined) {
+    setClauses.push("nickname = ?");
+    params.push(input.nickname);
+  }
+  if (input.avatar_url !== undefined) {
+    setClauses.push("avatar_url = ?");
+    params.push(input.avatar_url);
+  }
+  if (input.notes !== undefined) {
+    setClauses.push("notes = ?");
+    params.push(input.notes);
+  }
+  if (input.birthday !== undefined) {
+    setClauses.push("birthday = ?");
+    params.push(input.birthday);
+  }
+  if (input.company_id !== undefined) {
+    setClauses.push("company_id = ?");
+    params.push(input.company_id);
+  }
+  if (input.job_title !== undefined) {
+    setClauses.push("job_title = ?");
+    params.push(input.job_title);
+  }
+  if (input.source !== undefined) {
+    setClauses.push("source = ?");
+    params.push(input.source);
+  }
+  if (input.custom_fields !== undefined) {
+    setClauses.push("custom_fields = ?");
+    params.push(JSON.stringify(input.custom_fields));
+  }
+  params.push(id);
+  d.run(`UPDATE contacts SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  logActivity(d, { contact_id: id, action: "contact.updated", details: `Updated contact: ${existing.display_name}` });
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  return loadContactDetails(d, rowToContact(row));
+}
+function deleteContact(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  if (!row)
+    throw new ContactNotFoundError(id);
+  logActivity(d, { contact_id: id, action: "contact.deleted", details: `Deleted contact: ${row.display_name}` });
+  d.run(`DELETE FROM contacts WHERE id = ?`, [id]);
+}
+function searchContacts(query, db) {
+  const d = db || getDatabase();
+  const ftsRows = d.query(`
+    SELECT c.* FROM contacts c
+    JOIN contacts_fts fts ON fts.id = c.id
+    WHERE contacts_fts MATCH ?
+    ORDER BY rank
+    LIMIT 50
+  `).all(`"${query.replace(/"/g, '""')}"*`);
+  const emailRows = d.query(`
+    SELECT DISTINCT c.* FROM contacts c
+    JOIN emails e ON e.contact_id = c.id
+    WHERE e.address LIKE ?
+    LIMIT 20
+  `).all(`%${query}%`);
+  const phoneRows = d.query(`
+    SELECT DISTINCT c.* FROM contacts c
+    JOIN phones p ON p.contact_id = c.id
+    WHERE p.number LIKE ?
+    LIMIT 20
+  `).all(`%${query}%`);
+  const seen = new Set;
+  const allRows = [];
+  for (const row of [...ftsRows, ...emailRows, ...phoneRows]) {
+    if (!seen.has(row.id)) {
+      seen.add(row.id);
+      allRows.push(row);
+    }
+  }
+  return allRows.map((row) => loadContactDetails(d, rowToContact(row)));
+}
+function mergeContacts(keepId, mergeId, db) {
+  const d = db || getDatabase();
+  const keepRow = d.query(`SELECT * FROM contacts WHERE id = ?`).get(keepId);
+  if (!keepRow)
+    throw new ContactNotFoundError(keepId);
+  const mergeRow = d.query(`SELECT * FROM contacts WHERE id = ?`).get(mergeId);
+  if (!mergeRow)
+    throw new ContactNotFoundError(mergeId);
+  d.run(`UPDATE emails SET contact_id = ? WHERE contact_id = ?`, [keepId, mergeId]);
+  d.run(`UPDATE phones SET contact_id = ? WHERE contact_id = ?`, [keepId, mergeId]);
+  d.run(`UPDATE addresses SET contact_id = ? WHERE contact_id = ?`, [keepId, mergeId]);
+  d.run(`UPDATE social_profiles SET contact_id = ? WHERE contact_id = ?`, [keepId, mergeId]);
+  const mergeTags = d.query(`SELECT tag_id FROM contact_tags WHERE contact_id = ?`).all(mergeId);
+  for (const { tag_id } of mergeTags) {
+    d.run(`INSERT OR IGNORE INTO contact_tags (contact_id, tag_id) VALUES (?, ?)`, [keepId, tag_id]);
+  }
+  d.run(`UPDATE contact_relationships SET contact_a_id = ? WHERE contact_a_id = ?`, [keepId, mergeId]);
+  d.run(`UPDATE contact_relationships SET contact_b_id = ? WHERE contact_b_id = ?`, [keepId, mergeId]);
+  d.run(`UPDATE activity_log SET contact_id = ? WHERE contact_id = ?`, [keepId, mergeId]);
+  d.run(`DELETE FROM contacts WHERE id = ?`, [mergeId]);
+  const updates = ["updated_at = ?"];
+  const params = [now()];
+  if (!keepRow.notes && mergeRow.notes) {
+    updates.push("notes = ?");
+    params.push(mergeRow.notes);
+  }
+  if (!keepRow.nickname && mergeRow.nickname) {
+    updates.push("nickname = ?");
+    params.push(mergeRow.nickname);
+  }
+  if (!keepRow.avatar_url && mergeRow.avatar_url) {
+    updates.push("avatar_url = ?");
+    params.push(mergeRow.avatar_url);
+  }
+  if (!keepRow.birthday && mergeRow.birthday) {
+    updates.push("birthday = ?");
+    params.push(mergeRow.birthday);
+  }
+  if (!keepRow.company_id && mergeRow.company_id) {
+    updates.push("company_id = ?");
+    params.push(mergeRow.company_id);
+  }
+  if (!keepRow.job_title && mergeRow.job_title) {
+    updates.push("job_title = ?");
+    params.push(mergeRow.job_title);
+  }
+  params.push(keepId);
+  d.run(`UPDATE contacts SET ${updates.join(", ")} WHERE id = ?`, params);
+  logActivity(d, {
+    contact_id: keepId,
+    action: "contact.merged",
+    details: `Merged contact ${mergeRow.display_name} (${mergeId}) into ${keepRow.display_name} (${keepId})`
+  });
+  const finalRow = d.query(`SELECT * FROM contacts WHERE id = ?`).get(keepId);
+  return loadContactDetails(d, rowToContact(finalRow));
+}
+// src/db/companies.ts
+function rowToCompany2(row) {
+  return {
+    ...row,
+    custom_fields: JSON.parse(row.custom_fields || "{}")
+  };
+}
+function insertEmails2(db, companyId, emails) {
+  for (const e of emails) {
+    db.run(`INSERT INTO emails (id, contact_id, company_id, address, type, is_primary) VALUES (?, ?, ?, ?, ?, ?)`, [uuid(), null, companyId, e.address, e.type ?? "work", e.is_primary ? 1 : 0]);
+  }
+}
+function insertPhones2(db, companyId, phones) {
+  for (const p of phones) {
+    db.run(`INSERT INTO phones (id, contact_id, company_id, number, country_code, type, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?)`, [uuid(), null, companyId, p.number, p.country_code ?? null, p.type ?? "work", p.is_primary ? 1 : 0]);
+  }
+}
+function insertAddresses2(db, companyId, addresses) {
+  for (const a of addresses) {
+    db.run(`INSERT INTO addresses (id, contact_id, company_id, type, street, city, state, zip, country, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [uuid(), null, companyId, a.type ?? "physical", a.street ?? null, a.city ?? null, a.state ?? null, a.zip ?? null, a.country ?? null, a.is_primary ? 1 : 0]);
+  }
+}
+function insertSocialProfiles2(db, companyId, profiles) {
+  for (const s of profiles) {
+    db.run(`INSERT INTO social_profiles (id, contact_id, company_id, platform, handle, url, is_primary) VALUES (?, ?, ?, ?, ?, ?, ?)`, [uuid(), null, companyId, s.platform, s.handle ?? null, s.url ?? null, s.is_primary ? 1 : 0]);
+  }
+}
+function loadCompanyDetails(db, company) {
+  const emails = db.query(`SELECT * FROM emails WHERE company_id = ?`).all(company.id).map((row) => ({
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  }));
+  const phones = db.query(`SELECT * FROM phones WHERE company_id = ?`).all(company.id).map((row) => ({
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  }));
+  const addresses = db.query(`SELECT * FROM addresses WHERE company_id = ?`).all(company.id).map((row) => ({
+    ...row,
+    type: row.type,
+    is_primary: !!row.is_primary
+  }));
+  const social_profiles = db.query(`SELECT * FROM social_profiles WHERE company_id = ?`).all(company.id).map((row) => ({
+    ...row,
+    platform: row.platform,
+    is_primary: !!row.is_primary
+  }));
+  const tags = db.query(`
+    SELECT t.* FROM tags t
+    JOIN company_tags ct ON ct.tag_id = t.id
+    WHERE ct.company_id = ?
+  `).all(company.id);
+  const empCount = db.query(`SELECT COUNT(*) as count FROM contacts WHERE company_id = ?`).get(company.id);
+  return {
+    ...company,
+    emails,
+    phones,
+    addresses,
+    social_profiles,
+    tags,
+    employee_count: empCount.count
+  };
+}
+function createCompany(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO companies (id, name, domain, logo_url, description, industry, size, founded_year, notes, custom_fields, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.name,
+    input.domain ?? null,
+    input.logo_url ?? null,
+    input.description ?? null,
+    input.industry ?? null,
+    input.size ?? null,
+    input.founded_year ?? null,
+    input.notes ?? null,
+    JSON.stringify(input.custom_fields ?? {}),
+    timestamp,
+    timestamp
+  ]);
+  if (input.emails?.length)
+    insertEmails2(d, id, input.emails);
+  if (input.phones?.length)
+    insertPhones2(d, id, input.phones);
+  if (input.addresses?.length)
+    insertAddresses2(d, id, input.addresses);
+  if (input.social_profiles?.length)
+    insertSocialProfiles2(d, id, input.social_profiles);
+  if (input.tag_ids?.length) {
+    for (const tagId of input.tag_ids) {
+      d.run(`INSERT OR IGNORE INTO company_tags (company_id, tag_id) VALUES (?, ?)`, [id, tagId]);
+    }
+  }
+  logActivity(d, { company_id: id, action: "company.created", details: `Created company: ${input.name}` });
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  return loadCompanyDetails(d, rowToCompany2(row));
+}
+function getCompany(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  if (!row)
+    throw new CompanyNotFoundError(id);
+  return loadCompanyDetails(d, rowToCompany2(row));
+}
+function listCompanies(opts = {}, db) {
+  const d = db || getDatabase();
+  const {
+    limit = 50,
+    offset = 0,
+    industry,
+    tag_id,
+    order_by = "name",
+    order_dir = "asc"
+  } = opts;
+  const conditions = [];
+  const params = [];
+  if (industry) {
+    conditions.push("co.industry = ?");
+    params.push(industry);
+  }
+  if (tag_id) {
+    conditions.push("EXISTS (SELECT 1 FROM company_tags ct WHERE ct.company_id = co.id AND ct.tag_id = ?)");
+    params.push(tag_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const validOrderBy = ["name", "created_at", "updated_at"].includes(order_by) ? order_by : "name";
+  const validOrderDir = order_dir === "desc" ? "DESC" : "ASC";
+  const totalRow = d.query(`SELECT COUNT(*) as total FROM companies co ${where}`).get(...params);
+  const rows = d.query(`SELECT co.* FROM companies co ${where} ORDER BY co.${validOrderBy} ${validOrderDir} LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  const companies = rows.map((row) => loadCompanyDetails(d, rowToCompany2(row)));
+  return { companies, total: totalRow.total };
+}
+function updateCompany(id, input, db) {
+  const d = db || getDatabase();
+  const existing = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  if (!existing)
+    throw new CompanyNotFoundError(id);
+  const setClauses = ["updated_at = ?"];
+  const params = [now()];
+  if (input.name !== undefined) {
+    setClauses.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.domain !== undefined) {
+    setClauses.push("domain = ?");
+    params.push(input.domain);
+  }
+  if (input.logo_url !== undefined) {
+    setClauses.push("logo_url = ?");
+    params.push(input.logo_url);
+  }
+  if (input.description !== undefined) {
+    setClauses.push("description = ?");
+    params.push(input.description);
+  }
+  if (input.industry !== undefined) {
+    setClauses.push("industry = ?");
+    params.push(input.industry);
+  }
+  if (input.size !== undefined) {
+    setClauses.push("size = ?");
+    params.push(input.size);
+  }
+  if (input.founded_year !== undefined) {
+    setClauses.push("founded_year = ?");
+    params.push(input.founded_year);
+  }
+  if (input.notes !== undefined) {
+    setClauses.push("notes = ?");
+    params.push(input.notes);
+  }
+  if (input.custom_fields !== undefined) {
+    setClauses.push("custom_fields = ?");
+    params.push(JSON.stringify(input.custom_fields));
+  }
+  params.push(id);
+  d.run(`UPDATE companies SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  logActivity(d, { company_id: id, action: "company.updated", details: `Updated company: ${existing.name}` });
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  return loadCompanyDetails(d, rowToCompany2(row));
+}
+function deleteCompany(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  if (!row)
+    throw new CompanyNotFoundError(id);
+  logActivity(d, { company_id: id, action: "company.deleted", details: `Deleted company: ${row.name}` });
+  d.run(`DELETE FROM companies WHERE id = ?`, [id]);
+}
+function searchCompanies(query, db) {
+  const d = db || getDatabase();
+  const rows = d.query(`
+    SELECT * FROM companies
+    WHERE name LIKE ? OR domain LIKE ? OR description LIKE ? OR industry LIKE ?
+    LIMIT 50
+  `).all(`%${query}%`, `%${query}%`, `%${query}%`, `%${query}%`);
+  return rows.map((row) => loadCompanyDetails(d, rowToCompany2(row)));
+}
+function listCompanyEmployees(companyId, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT id FROM companies WHERE id = ?`).get(companyId);
+  if (!row)
+    throw new CompanyNotFoundError(companyId);
+  const rows = d.query(`SELECT * FROM contacts WHERE company_id = ? ORDER BY display_name ASC`).all(companyId);
+  return rows.map((r) => ({
+    ...r,
+    source: r.source,
+    custom_fields: JSON.parse(r.custom_fields || "{}")
+  }));
+}
+// src/db/tags.ts
+function rowToTag2(row) {
+  return { ...row };
+}
+function createTag(input, db) {
+  const d = db || getDatabase();
+  const existing = d.query(`SELECT id FROM tags WHERE name = ?`).get(input.name);
+  if (existing)
+    throw new DuplicateTagNameError(input.name);
+  const id = uuid();
+  d.run(`INSERT INTO tags (id, name, color, description) VALUES (?, ?, ?, ?)`, [id, input.name, input.color ?? "#6366f1", input.description ?? null]);
+  return rowToTag2(d.query(`SELECT * FROM tags WHERE id = ?`).get(id));
+}
+function getTag(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM tags WHERE id = ?`).get(id);
+  if (!row)
+    throw new TagNotFoundError(id);
+  return rowToTag2(row);
+}
+function getTagByName(name, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM tags WHERE name = ?`).get(name);
+  return row ? rowToTag2(row) : null;
+}
+function listTags(db) {
+  const d = db || getDatabase();
+  return d.query(`SELECT * FROM tags ORDER BY name ASC`).all().map(rowToTag2);
+}
+function updateTag(id, input, db) {
+  const d = db || getDatabase();
+  const existing = d.query(`SELECT * FROM tags WHERE id = ?`).get(id);
+  if (!existing)
+    throw new TagNotFoundError(id);
+  if (input.name && input.name !== existing.name) {
+    const dupe = d.query(`SELECT id FROM tags WHERE name = ? AND id != ?`).get(input.name, id);
+    if (dupe)
+      throw new DuplicateTagNameError(input.name);
+  }
+  const setClauses = [];
+  const params = [];
+  if (input.name !== undefined) {
+    setClauses.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.color !== undefined) {
+    setClauses.push("color = ?");
+    params.push(input.color);
+  }
+  if (input.description !== undefined) {
+    setClauses.push("description = ?");
+    params.push(input.description);
+  }
+  if (setClauses.length > 0) {
+    params.push(id);
+    d.run(`UPDATE tags SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  }
+  return rowToTag2(d.query(`SELECT * FROM tags WHERE id = ?`).get(id));
+}
+function deleteTag(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT id FROM tags WHERE id = ?`).get(id);
+  if (!row)
+    throw new TagNotFoundError(id);
+  d.run(`DELETE FROM tags WHERE id = ?`, [id]);
+}
+function addTagToContact(contactId, tagId, db) {
+  const d = db || getDatabase();
+  const contact = d.query(`SELECT id FROM contacts WHERE id = ?`).get(contactId);
+  if (!contact)
+    throw new ContactNotFoundError(contactId);
+  const tag = d.query(`SELECT id FROM tags WHERE id = ?`).get(tagId);
+  if (!tag)
+    throw new TagNotFoundError(tagId);
+  d.run(`INSERT OR IGNORE INTO contact_tags (contact_id, tag_id) VALUES (?, ?)`, [contactId, tagId]);
+}
+function removeTagFromContact(contactId, tagId, db) {
+  const d = db || getDatabase();
+  d.run(`DELETE FROM contact_tags WHERE contact_id = ? AND tag_id = ?`, [contactId, tagId]);
+}
+function listContactsByTag(tagId, db) {
+  const d = db || getDatabase();
+  const tag = d.query(`SELECT id FROM tags WHERE id = ?`).get(tagId);
+  if (!tag)
+    throw new TagNotFoundError(tagId);
+  const rows = d.query(`
+    SELECT c.* FROM contacts c
+    JOIN contact_tags ct ON ct.contact_id = c.id
+    WHERE ct.tag_id = ?
+    ORDER BY c.display_name ASC
+  `).all(tagId);
+  return rows.map((r) => ({
+    ...r,
+    source: r.source,
+    custom_fields: JSON.parse(r.custom_fields || "{}")
+  }));
+}
+function addTagToCompany(companyId, tagId, db) {
+  const d = db || getDatabase();
+  const company = d.query(`SELECT id FROM companies WHERE id = ?`).get(companyId);
+  if (!company)
+    throw new CompanyNotFoundError(companyId);
+  const tag = d.query(`SELECT id FROM tags WHERE id = ?`).get(tagId);
+  if (!tag)
+    throw new TagNotFoundError(tagId);
+  d.run(`INSERT OR IGNORE INTO company_tags (company_id, tag_id) VALUES (?, ?)`, [companyId, tagId]);
+}
+function removeTagFromCompany(companyId, tagId, db) {
+  const d = db || getDatabase();
+  d.run(`DELETE FROM company_tags WHERE company_id = ? AND tag_id = ?`, [companyId, tagId]);
+}
+// src/db/relationships.ts
+function rowToRelationship(row) {
+  return {
+    ...row,
+    relationship_type: row.relationship_type
+  };
+}
+function createRelationship(input, db) {
+  const d = db || getDatabase();
+  const a = d.query(`SELECT id FROM contacts WHERE id = ?`).get(input.contact_a_id);
+  if (!a)
+    throw new ContactNotFoundError(input.contact_a_id);
+  const b = d.query(`SELECT id FROM contacts WHERE id = ?`).get(input.contact_b_id);
+  if (!b)
+    throw new ContactNotFoundError(input.contact_b_id);
+  const id = uuid();
+  d.run(`INSERT INTO contact_relationships (id, contact_a_id, contact_b_id, relationship_type, notes) VALUES (?, ?, ?, ?, ?)`, [id, input.contact_a_id, input.contact_b_id, input.relationship_type, input.notes ?? null]);
+  return rowToRelationship(d.query(`SELECT * FROM contact_relationships WHERE id = ?`).get(id));
+}
+function listRelationships(opts = {}, db) {
+  const d = db || getDatabase();
+  const { contact_id, relationship_type } = opts;
+  const conditions = [];
+  const params = [];
+  if (contact_id) {
+    conditions.push("(contact_a_id = ? OR contact_b_id = ?)");
+    params.push(contact_id, contact_id);
+  }
+  if (relationship_type) {
+    conditions.push("relationship_type = ?");
+    params.push(relationship_type);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM contact_relationships ${where} ORDER BY created_at DESC`).all(...params);
+  return rows.map(rowToRelationship);
+}
+function getRelationship(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contact_relationships WHERE id = ?`).get(id);
+  return row ? rowToRelationship(row) : null;
+}
+function deleteRelationship(id, db) {
+  const d = db || getDatabase();
+  d.run(`DELETE FROM contact_relationships WHERE id = ?`, [id]);
+}
+export {
+  updateTag,
+  updateContact,
+  updateCompany,
+  searchContacts,
+  searchCompanies,
+  resetDatabase,
+  removeTagFromContact,
+  removeTagFromCompany,
+  mergeContacts,
+  logActivity,
+  listTags,
+  listRelationships,
+  listContactsByTag,
+  listContacts,
+  listCompanyEmployees,
+  listCompanies,
+  listActivity,
+  getTagByName,
+  getTag,
+  getRelationship,
+  getDatabase,
+  getContact,
+  getCompany,
+  getActivity,
+  deleteTag,
+  deleteRelationship,
+  deleteContact,
+  deleteCompany,
+  createTag,
+  createRelationship,
+  createContact,
+  createCompany,
+  addTagToContact,
+  addTagToCompany,
+  TagNotFoundError,
+  DuplicateTagNameError,
+  ContactNotFoundError,
+  CompanyNotFoundError
+};