@hasna/contacts 0.2.2 → 0.2.4

package/dist/index.js

@@ -188,6 +188,20 @@ var MIGRATIONS = [
     group_id TEXT NOT NULL REFERENCES groups(id) ON DELETE CASCADE,
     PRIMARY KEY (contact_id, group_id)
   );
+  `,
+  `
+  ALTER TABLE contacts ADD COLUMN status TEXT DEFAULT 'active';
+  ALTER TABLE contacts ADD COLUMN follow_up_at TEXT;
+  ALTER TABLE contacts ADD COLUMN archived INTEGER NOT NULL DEFAULT 0;
+  ALTER TABLE contacts ADD COLUMN project_id TEXT;
+  ALTER TABLE companies ADD COLUMN archived INTEGER NOT NULL DEFAULT 0;
+  ALTER TABLE companies ADD COLUMN project_id TEXT;
+
+  CREATE TABLE IF NOT EXISTS company_groups (
+    company_id TEXT NOT NULL REFERENCES companies(id) ON DELETE CASCADE,
+    group_id TEXT NOT NULL REFERENCES groups(id) ON DELETE CASCADE,
+    PRIMARY KEY (company_id, group_id)
+  );
   `
 ];
 var _db = null;
@@ -299,7 +313,11 @@ function rowToContact(row) {
     ...row,
     source: row.source,
     custom_fields: JSON.parse(row.custom_fields || "{}"),
-    preferred_contact_method: row.preferred_contact_method ?? null
+    preferred_contact_method: row.preferred_contact_method ?? null,
+    status: row.status ?? "active",
+    follow_up_at: row.follow_up_at ?? null,
+    archived: !!row.archived,
+    project_id: row.project_id ?? null
   };
 }
 function rowToEmail(row) {
@@ -336,7 +354,9 @@ function rowToTag(row) {
 function rowToCompany(row) {
   return {
     ...row,
-    custom_fields: JSON.parse(row.custom_fields || "{}")
+    custom_fields: JSON.parse(row.custom_fields || "{}"),
+    archived: !!row.archived,
+    project_id: row.project_id ?? null
   };
 }
 function insertEmails(db, contactId, companyId, emails) {
@@ -380,8 +400,8 @@ function createContact(input, db) {
   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, last_contacted_at, website, preferred_contact_method, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO contacts (id, first_name, last_name, display_name, nickname, avatar_url, notes, birthday, company_id, job_title, source, custom_fields, last_contacted_at, website, preferred_contact_method, status, follow_up_at, project_id, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     firstName,
     lastName,
@@ -397,6 +417,9 @@ function createContact(input, db) {
     input.last_contacted_at ?? null,
     input.website ?? null,
     input.preferred_contact_method ?? null,
+    input.status ?? "active",
+    input.follow_up_at ?? null,
+    input.project_id ?? null,
     timestamp,
     timestamp
   ]);
@@ -431,12 +454,21 @@ function listContacts(opts = {}, db) {
     offset = 0,
     company_id,
     tag_id,
+    tag_ids,
     source,
+    status,
+    project_id,
+    archived = false,
+    follow_up_due,
+    last_contacted_after,
+    last_contacted_before,
     order_by = "display_name",
     order_dir = "asc"
   } = opts;
   const conditions = [];
   const params = [];
+  conditions.push("c.archived = ?");
+  params.push(archived ? 1 : 0);
   if (company_id) {
     conditions.push("c.company_id = ?");
     params.push(company_id);
@@ -445,12 +477,37 @@ function listContacts(opts = {}, db) {
     conditions.push("c.source = ?");
     params.push(source);
   }
+  if (status) {
+    conditions.push("c.status = ?");
+    params.push(status);
+  }
+  if (project_id) {
+    conditions.push("c.project_id = ?");
+    params.push(project_id);
+  }
   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);
   }
+  if (tag_ids?.length) {
+    for (const tid of tag_ids) {
+      conditions.push("EXISTS (SELECT 1 FROM contact_tags ct WHERE ct.contact_id = c.id AND ct.tag_id = ?)");
+      params.push(tid);
+    }
+  }
+  if (follow_up_due) {
+    conditions.push("c.follow_up_at IS NOT NULL AND c.follow_up_at <= datetime('now')");
+  }
+  if (last_contacted_after) {
+    conditions.push("c.last_contacted_at >= ?");
+    params.push(last_contacted_after);
+  }
+  if (last_contacted_before) {
+    conditions.push("c.last_contacted_at <= ?");
+    params.push(last_contacted_before);
+  }
   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 validOrderBy = ["display_name", "created_at", "updated_at", "last_contacted_at", "follow_up_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);
@@ -520,8 +577,36 @@ function updateContact(id, input, db) {
     setClauses.push("preferred_contact_method = ?");
     params.push(input.preferred_contact_method);
   }
+  if (input.status !== undefined) {
+    setClauses.push("status = ?");
+    params.push(input.status);
+  }
+  if (input.follow_up_at !== undefined) {
+    setClauses.push("follow_up_at = ?");
+    params.push(input.follow_up_at);
+  }
+  if (input.project_id !== undefined) {
+    setClauses.push("project_id = ?");
+    params.push(input.project_id);
+  }
   params.push(id);
   d.run(`UPDATE contacts SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  if (input.emails_add?.length) {
+    for (const e of input.emails_add) {
+      const exists = d.query(`SELECT id FROM emails WHERE contact_id = ? AND LOWER(address) = LOWER(?)`).get(id, e.address);
+      if (!exists) {
+        d.run(`INSERT INTO emails (id, contact_id, company_id, address, type, is_primary) VALUES (?, ?, NULL, ?, ?, ?)`, [uuid(), id, e.address, e.type ?? "work", e.is_primary ? 1 : 0]);
+      }
+    }
+  }
+  if (input.phones_add?.length) {
+    for (const p of input.phones_add) {
+      const exists = d.query(`SELECT id FROM phones WHERE contact_id = ? AND number = ?`).get(id, p.number);
+      if (!exists) {
+        d.run(`INSERT INTO phones (id, contact_id, company_id, number, country_code, type, is_primary) VALUES (?, ?, NULL, ?, ?, ?, ?)`, [uuid(), id, p.number, p.country_code ?? null, p.type ?? "mobile", p.is_primary ? 1 : 0]);
+      }
+    }
+  }
   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));
@@ -539,25 +624,31 @@ function searchContacts(query, db) {
   const ftsRows = d.query(`
     SELECT c.* FROM contacts c
     JOIN contacts_fts fts ON fts.id = c.id
-    WHERE contacts_fts MATCH ?
+    WHERE contacts_fts MATCH ? AND c.archived = 0
     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 ?
+    WHERE e.address LIKE ? AND c.archived = 0
     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 ?
+    WHERE p.number LIKE ? AND c.archived = 0
+    LIMIT 20
+  `).all(`%${query}%`);
+  const companyRows = d.query(`
+    SELECT DISTINCT c.* FROM contacts c
+    JOIN companies co ON co.id = c.company_id
+    WHERE co.name LIKE ? AND c.archived = 0
     LIMIT 20
   `).all(`%${query}%`);
   const seen = new Set;
   const allRows = [];
-  for (const row of [...ftsRows, ...emailRows, ...phoneRows]) {
+  for (const row of [...ftsRows, ...emailRows, ...phoneRows, ...companyRows]) {
     if (!seen.has(row.id)) {
       seen.add(row.id);
       allRows.push(row);
@@ -578,8 +669,24 @@ function mergeContacts(keepId, mergeId, db) {
   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]);
+  const mergeEmailRows = d.query(`SELECT * FROM emails WHERE contact_id = ?`).all(mergeId);
+  for (const e of mergeEmailRows) {
+    const exists = d.query(`SELECT id FROM emails WHERE contact_id = ? AND LOWER(address) = LOWER(?)`).get(keepId, e.address);
+    if (exists) {
+      d.run(`DELETE FROM emails WHERE id = ?`, [e.id]);
+    } else {
+      d.run(`UPDATE emails SET contact_id = ? WHERE id = ?`, [keepId, e.id]);
+    }
+  }
+  const mergePhoneRows = d.query(`SELECT * FROM phones WHERE contact_id = ?`).all(mergeId);
+  for (const p of mergePhoneRows) {
+    const exists = d.query(`SELECT id FROM phones WHERE contact_id = ? AND number = ?`).get(keepId, p.number);
+    if (exists) {
+      d.run(`DELETE FROM phones WHERE id = ?`, [p.id]);
+    } else {
+      d.run(`UPDATE phones SET contact_id = ? WHERE id = ?`, [keepId, p.id]);
+    }
+  }
   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);
@@ -626,11 +733,86 @@ function mergeContacts(keepId, mergeId, db) {
   const finalRow = d.query(`SELECT * FROM contacts WHERE id = ?`).get(keepId);
   return loadContactDetails(d, rowToContact(finalRow));
 }
+function getContactByEmail(email, db) {
+  const d = db || getDatabase();
+  const emailRow = d.query(`SELECT contact_id FROM emails WHERE LOWER(address) = LOWER(?) AND contact_id IS NOT NULL LIMIT 1`).get(email);
+  if (!emailRow)
+    return null;
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(emailRow.contact_id);
+  if (!row)
+    return null;
+  return loadContactDetails(d, rowToContact(row));
+}
+function addEmailToContact(contactId, email, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  if (!row)
+    throw new ContactNotFoundError(contactId);
+  const exists = d.query(`SELECT id FROM emails WHERE contact_id = ? AND LOWER(address) = LOWER(?)`).get(contactId, email.address);
+  if (!exists) {
+    d.run(`INSERT INTO emails (id, contact_id, company_id, address, type, is_primary) VALUES (?, ?, NULL, ?, ?, ?)`, [uuid(), contactId, email.address, email.type ?? "work", email.is_primary ? 1 : 0]);
+  }
+  const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  return loadContactDetails(d, rowToContact(updated));
+}
+function addPhoneToContact(contactId, phone, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  if (!row)
+    throw new ContactNotFoundError(contactId);
+  const exists = d.query(`SELECT id FROM phones WHERE contact_id = ? AND number = ?`).get(contactId, phone.number);
+  if (!exists) {
+    d.run(`INSERT INTO phones (id, contact_id, company_id, number, country_code, type, is_primary) VALUES (?, ?, NULL, ?, ?, ?, ?)`, [uuid(), contactId, phone.number, phone.country_code ?? null, phone.type ?? "mobile", phone.is_primary ? 1 : 0]);
+  }
+  const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  return loadContactDetails(d, rowToContact(updated));
+}
+function archiveContact(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  if (!row)
+    throw new ContactNotFoundError(id);
+  d.run(`UPDATE contacts SET archived = 1, updated_at = ? WHERE id = ?`, [now(), id]);
+  logActivity(d, { contact_id: id, action: "contact.archived", details: `Archived contact: ${row.display_name}` });
+  const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  return loadContactDetails(d, rowToContact(updated));
+}
+function unarchiveContact(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  if (!row)
+    throw new ContactNotFoundError(id);
+  d.run(`UPDATE contacts SET archived = 0, updated_at = ? WHERE id = ?`, [now(), id]);
+  logActivity(d, { contact_id: id, action: "contact.unarchived", details: `Unarchived contact: ${row.display_name}` });
+  const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
+  return loadContactDetails(d, rowToContact(updated));
+}
+function autoLinkContactToCompany(contactId, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  if (!row || row.company_id)
+    return null;
+  const emailRow = d.query(`SELECT address FROM emails WHERE contact_id = ? AND contact_id IS NOT NULL LIMIT 1`).get(contactId);
+  if (!emailRow)
+    return null;
+  const domain = emailRow.address.split("@")[1];
+  if (!domain)
+    return null;
+  const companyRow = d.query(`SELECT id FROM companies WHERE domain = ? LIMIT 1`).get(domain);
+  if (!companyRow)
+    return null;
+  d.run(`UPDATE contacts SET company_id = ?, updated_at = ? WHERE id = ?`, [companyRow.id, now(), contactId]);
+  logActivity(d, { contact_id: contactId, action: "contact.auto_linked", details: `Auto-linked to company via email domain: ${domain}` });
+  const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
+  return loadContactDetails(d, rowToContact(updated));
+}
 // src/db/companies.ts
 function rowToCompany2(row) {
   return {
     ...row,
-    custom_fields: JSON.parse(row.custom_fields || "{}")
+    custom_fields: JSON.parse(row.custom_fields || "{}"),
+    archived: !!row.archived,
+    project_id: row.project_id ?? null
   };
 }
 function insertEmails2(db, companyId, emails) {
@@ -740,15 +922,23 @@ function listCompanies(opts = {}, db) {
     offset = 0,
     industry,
     tag_id,
+    project_id,
+    archived = false,
     order_by = "name",
     order_dir = "asc"
   } = opts;
   const conditions = [];
   const params = [];
+  conditions.push("co.archived = ?");
+  params.push(archived ? 1 : 0);
   if (industry) {
     conditions.push("co.industry = ?");
     params.push(industry);
   }
+  if (project_id) {
+    conditions.push("co.project_id = ?");
+    params.push(project_id);
+  }
   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);
@@ -804,6 +994,10 @@ function updateCompany(id, input, db) {
     setClauses.push("custom_fields = ?");
     params.push(JSON.stringify(input.custom_fields));
   }
+  if ("project_id" in input && input.project_id !== undefined) {
+    setClauses.push("project_id = ?");
+    params.push(input.project_id);
+  }
   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}` });
@@ -837,9 +1031,33 @@ function listCompanyEmployees(companyId, db) {
     ...r,
     source: r.source,
     custom_fields: JSON.parse(r.custom_fields || "{}"),
-    preferred_contact_method: r.preferred_contact_method ?? null
+    preferred_contact_method: r.preferred_contact_method ?? null,
+    status: r.status ?? "active",
+    follow_up_at: r.follow_up_at ?? null,
+    archived: !!r.archived,
+    project_id: r.project_id ?? null
   }));
 }
+function archiveCompany(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  if (!row)
+    throw new CompanyNotFoundError(id);
+  d.run(`UPDATE companies SET archived = 1, updated_at = ? WHERE id = ?`, [now(), id]);
+  logActivity(d, { company_id: id, action: "company.archived", details: `Archived company: ${row.name}` });
+  const updated = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  return loadCompanyDetails(d, rowToCompany2(updated));
+}
+function unarchiveCompany(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  if (!row)
+    throw new CompanyNotFoundError(id);
+  d.run(`UPDATE companies SET archived = 0, updated_at = ? WHERE id = ?`, [now(), id]);
+  logActivity(d, { company_id: id, action: "company.unarchived", details: `Unarchived company: ${row.name}` });
+  const updated = d.query(`SELECT * FROM companies WHERE id = ?`).get(id);
+  return loadCompanyDetails(d, rowToCompany2(updated));
+}
 // src/db/tags.ts
 function rowToTag2(row) {
   return { ...row };
@@ -935,7 +1153,11 @@ function listContactsByTag(tagId, db) {
     ...r,
     source: r.source,
     custom_fields: JSON.parse(r.custom_fields || "{}"),
-    preferred_contact_method: r.preferred_contact_method ?? null
+    preferred_contact_method: r.preferred_contact_method ?? null,
+    status: r.status ?? "active",
+    follow_up_at: r.follow_up_at ?? null,
+    archived: !!r.archived,
+    project_id: r.project_id ?? null
   }));
 }
 function addTagToCompany(companyId, tagId, db) {
@@ -1007,7 +1229,10 @@ function getGroup(db, id) {
   return db.query(`SELECT * FROM groups WHERE id = ?`).get(id);
 }
 function listGroups(db) {
-  return db.query(`SELECT g.*, COUNT(cg.contact_id) as member_count FROM groups g LEFT JOIN contact_groups cg ON g.id = cg.group_id GROUP BY g.id ORDER BY g.name`).all();
+  return db.query(`SELECT g.*,
+       (SELECT COUNT(*) FROM contact_groups cg WHERE cg.group_id = g.id) as member_count,
+       (SELECT COUNT(*) FROM company_groups cog WHERE cog.group_id = g.id) as company_count
+     FROM groups g ORDER BY g.name`).all();
 }
 function updateGroup(db, id, input) {
   const fields = [];
@@ -1030,7 +1255,11 @@ function deleteGroup(db, id) {
   db.query(`DELETE FROM groups WHERE id = ?`).run(id);
 }
 function addContactToGroup(db, contactId, groupId) {
-  db.query(`INSERT OR IGNORE INTO contact_groups(contact_id, group_id) VALUES(?,?)`).run(contactId, groupId);
+  const existing = db.query(`SELECT 1 FROM contact_groups WHERE contact_id = ? AND group_id = ?`).get(contactId, groupId);
+  if (existing)
+    return { added: false, already_member: true };
+  db.query(`INSERT INTO contact_groups(contact_id, group_id) VALUES(?,?)`).run(contactId, groupId);
+  return { added: true, already_member: false };
 }
 function removeContactFromGroup(db, contactId, groupId) {
   db.query(`DELETE FROM contact_groups WHERE contact_id = ? AND group_id = ?`).run(contactId, groupId);
@@ -1042,28 +1271,50 @@ function listContactsInGroup(db, groupId) {
 function listGroupsForContact(db, contactId) {
   return db.query(`SELECT g.* FROM groups g JOIN contact_groups cg ON g.id = cg.group_id WHERE cg.contact_id = ? ORDER BY g.name`).all(contactId);
 }
+function addCompanyToGroup(db, companyId, groupId) {
+  const existing = db.query(`SELECT 1 FROM company_groups WHERE company_id = ? AND group_id = ?`).get(companyId, groupId);
+  if (existing)
+    return { added: false, already_member: true };
+  db.query(`INSERT INTO company_groups(company_id, group_id) VALUES(?,?)`).run(companyId, groupId);
+  return { added: true, already_member: false };
+}
+function removeCompanyFromGroup(db, companyId, groupId) {
+  db.query(`DELETE FROM company_groups WHERE company_id = ? AND group_id = ?`).run(companyId, groupId);
+}
+function listCompaniesInGroup(db, groupId) {
+  const rows = db.query(`SELECT company_id FROM company_groups WHERE group_id = ?`).all(groupId);
+  return rows.map((r) => r.company_id);
+}
+function listGroupsForCompany(db, companyId) {
+  return db.query(`SELECT g.* FROM groups g JOIN company_groups cog ON g.id = cog.group_id WHERE cog.company_id = ? ORDER BY g.name`).all(companyId);
+}
 export {
   updateTag,
   updateGroup,
   updateContact,
   updateCompany,
+  unarchiveContact,
+  unarchiveCompany,
   searchContacts,
   searchCompanies,
   resetDatabase,
   removeTagFromContact,
   removeTagFromCompany,
   removeContactFromGroup,
+  removeCompanyFromGroup,
   mergeContacts,
   logActivity,
   listTags,
   listRelationships,
   listRecentContacts,
   listGroupsForContact,
+  listGroupsForCompany,
   listGroups,
   listContactsInGroup,
   listContactsByTag,
   listContacts,
   listCompanyEmployees,
+  listCompaniesInGroup,
   listCompanies,
   listActivity,
   getTagByName,
@@ -1071,6 +1322,7 @@ export {
   getRelationship,
   getGroup,
   getDatabase,
+  getContactByEmail,
   getContact,
   getCompany,
   getActivity,
@@ -1084,9 +1336,15 @@ export {
   createGroup,
   createContact,
   createCompany,
+  autoLinkContactToCompany,
+  archiveContact,
+  archiveCompany,
   addTagToContact,
   addTagToCompany,
+  addPhoneToContact,
+  addEmailToContact,
   addContactToGroup,
+  addCompanyToGroup,
   TagNotFoundError,
   DuplicateTagNameError,
   ContactNotFoundError,

package/dist/lib/gmail-import.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Gmail contact import — fetches messages matching a query, extracts unique
+ * senders/recipients, and returns them as CreateContactInput objects.
+ *
+ * Uses the Gmail REST API directly with tokens stored at
+ * ~/.connectors/connect-gmail/profiles/default/tokens.json
+ * (requires connect-gmail auth login to be completed first).
+ */
+import type { CreateContactInput } from "../types/index.js";
+/**
+ * Parse a single RFC 5322 address header value into { name, email } pairs.
+ * Handles: "Name <email>", "<email>", "email", and comma-separated lists.
+ */
+export declare function parseAddressHeader(header: string): Array<{
+    name: string;
+    email: string;
+}>;
+export interface GmailImportOptions {
+    query: string;
+    /** Max messages to scan (default 200, max 500) */
+    max_messages?: number;
+    /** Gmail profile to use (default: "default") */
+    gmail_profile?: string;
+    tag_ids?: string[];
+    group_id?: string;
+}
+export interface ExtractedContact {
+    email: string;
+    name: string;
+    company_hint: string | null;
+    contact_input: CreateContactInput;
+}
+/**
+ * Fetch messages matching `query` from Gmail and extract unique contacts.
+ * Does NOT write to the database — returns prepared CreateContactInput objects.
+ */
+export declare function extractContactsFromGmail(opts: GmailImportOptions): Promise<ExtractedContact[]>;
+//# sourceMappingURL=gmail-import.d.ts.map

package/dist/lib/gmail-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-import.d.ts","sourceRoot":"","sources":["../../src/lib/gmail-import.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAoD5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBzF;AAqCD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoF7B"}

package/dist/lib/gmail-import.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gmail-import.test.d.ts.map

package/dist/lib/gmail-import.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-import.test.d.ts","sourceRoot":"","sources":["../../src/lib/gmail-import.test.ts"],"names":[],"mappings":""}