@hasna/contacts 0.2.8 → 0.2.9

package/dist/index.d.ts

@@ -5,6 +5,12 @@ export { createTag, getTag, getTagByName, listTags, updateTag, deleteTag, addTag
 export { createRelationship, listRelationships, getRelationship, deleteRelationship, } from "./db/relationships.js";
 export { createGroup, getGroup, listGroups, updateGroup, deleteGroup, addContactToGroup, removeContactFromGroup, listContactsInGroup, listGroupsForContact, addCompanyToGroup, removeCompanyFromGroup, listCompaniesInGroup, listGroupsForCompany, } from "./db/groups.js";
 export { logActivity, listActivity, getActivity } from "./db/activity.js";
+export { runConnector, readConnectorTokens, getConnectorTokenPath, ConnectorNotInstalledError, ConnectorAuthError } from "./lib/connector.js";
+export type { ConnectorRunOptions } from "./lib/connector.js";
+export { extractContactsFromGmail, parseAddressHeader, domainToCompany, parseName } from "./lib/gmail-import.js";
+export type { GmailImportOptions, ExtractedContact } from "./lib/gmail-import.js";
+export { listGoogleContacts, searchGoogleContacts, pullGoogleContactsAsInputs, pushContactToGoogle, googlePersonToContactInput, contactToGoogleArgs, } from "./lib/google-contacts.js";
+export type { GooglePerson, GoogleContactsSyncOptions, GoogleContactsPushOptions, SyncResult } from "./lib/google-contacts.js";
 export type { EmailType, PhoneType, AddressType, SocialPlatform, RelationshipType, ContactSource, PreferredContactMethod, ContactStatus, Email, Phone, Address, SocialProfile, Tag, Contact, ContactWithDetails, Company, CompanyWithDetails, ContactRelationship, ActivityLog, Webhook, Group, CreateGroupInput, CreateEmailInput, CreatePhoneInput, CreateAddressInput, CreateSocialProfileInput, CreateTagInput, UpdateTagInput, CreateContactInput, UpdateContactInput, ContactListOptions, CreateCompanyInput, UpdateCompanyInput, CompanyListOptions, CreateRelationshipInput, CreateActivityInput, CreateWebhookInput, UpdateWebhookInput, DuplicateByEmail, DuplicateByName, ContactRow, CompanyRow, EmailRow, PhoneRow, AddressRow, SocialProfileRow, TagRow, RelationshipRow, ActivityRow, WebhookRow, } from "./types/index.js";
 export { ContactNotFoundError, CompanyNotFoundError, TagNotFoundError, DuplicateTagNameError, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG1E,YAAY,EAEV,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,aAAa,EAEb,KAAK,EACL,KAAK,EACL,OAAO,EACP,aAAa,EAEb,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,KAAK,EACL,gBAAgB,EAEhB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAEf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC9I,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACjH,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGlF,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG/H,YAAY,EAEV,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,aAAa,EAEb,KAAK,EACL,KAAK,EACL,OAAO,EACP,aAAa,EAEb,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,KAAK,EACL,gBAAgB,EAEhB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAEf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1312,6 +1312,354 @@ function listCompaniesInGroup(db, groupId) {
 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);
 }
+// src/lib/connector.ts
+import { join as join2 } from "path";
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { homedir } from "os";
+
+class ConnectorNotInstalledError extends Error {
+  connectorName;
+  constructor(connectorName) {
+    super(`connect-${connectorName} is not installed. ` + `Run: bun install -g @hasnaxyz/connect-${connectorName}`);
+    this.connectorName = connectorName;
+    this.name = "ConnectorNotInstalledError";
+  }
+}
+
+class ConnectorAuthError extends Error {
+  connectorName;
+  constructor(connectorName, detail) {
+    super(`connect-${connectorName} is not authenticated. ` + `Run: connect-${connectorName} auth login` + (detail ? ` (${detail})` : ""));
+    this.connectorName = connectorName;
+    this.name = "ConnectorAuthError";
+  }
+}
+async function runConnector(name, args, opts = {}) {
+  const binary = `connect-${name}`;
+  const profile = opts.profile ?? "default";
+  const fullArgs = [
+    "--format",
+    "json",
+    "--profile",
+    profile,
+    ...args
+  ];
+  let proc;
+  try {
+    proc = Bun.spawn([binary, ...fullArgs], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("not found") || msg.includes("ENOENT")) {
+      throw new ConnectorNotInstalledError(name);
+    }
+    throw err;
+  }
+  const timeoutMs = opts.timeout ?? 30000;
+  const timer = setTimeout(() => proc.kill(), timeoutMs);
+  try {
+    const [stdout, stderr, exitCode] = await Promise.all([
+      proc.stdout ? new Response(proc.stdout).text() : Promise.resolve(""),
+      proc.stderr ? new Response(proc.stderr).text() : Promise.resolve(""),
+      proc.exited
+    ]);
+    if (exitCode !== 0) {
+      const errText = (stderr || stdout).trim();
+      const lower = errText.toLowerCase();
+      if (lower.includes("auth") || lower.includes("token") || lower.includes("401") || lower.includes("unauthorized") || lower.includes("not authenticated")) {
+        throw new ConnectorAuthError(name, errText.slice(0, 200));
+      }
+      throw new Error(`connect-${name} exited ${exitCode}: ${errText.slice(0, 400)}`);
+    }
+    const text = stdout.trim();
+    if (!text || text === "null")
+      return null;
+    return JSON.parse(text);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function getConnectorTokenPath(name, profile = "default") {
+  const bases = [
+    join2(homedir(), ".connectors", `connect-${name}`, "profiles", profile, "tokens.json"),
+    join2(homedir(), ".connect", `connect-${name}`, "profiles", profile, "tokens.json"),
+    join2(homedir(), ".connect", `connect-${name}`, "tokens.json")
+  ];
+  for (const p of bases) {
+    if (existsSync2(p))
+      return p;
+  }
+  return null;
+}
+function readConnectorTokens(name, profile = "default") {
+  const path = getConnectorTokenPath(name, profile);
+  if (!path)
+    throw new ConnectorAuthError(name);
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    throw new ConnectorAuthError(name, "tokens file unreadable");
+  }
+}
+// src/lib/gmail-import.ts
+function parseAddressHeader(header) {
+  const results = [];
+  const parts = header.split(/,(?![^<>]*>)(?![^"]*")/);
+  for (const part of parts) {
+    const trimmed = part.trim();
+    if (!trimmed)
+      continue;
+    const angleMatch = trimmed.match(/^(.*?)\s*<([^>]+)>\s*$/);
+    if (angleMatch) {
+      const name = angleMatch[1].trim().replace(/^"|"$/g, "");
+      const email = angleMatch[2].trim().toLowerCase();
+      if (email.includes("@"))
+        results.push({ name, email });
+    } else if (trimmed.includes("@")) {
+      results.push({ name: "", email: trimmed.toLowerCase() });
+    }
+  }
+  return results;
+}
+function domainToCompany(email) {
+  const domain = email.split("@")[1];
+  if (!domain)
+    return null;
+  const genericDomains = new Set([
+    "gmail.com",
+    "googlemail.com",
+    "yahoo.com",
+    "yahoo.co.uk",
+    "hotmail.com",
+    "hotmail.co.uk",
+    "outlook.com",
+    "live.com",
+    "icloud.com",
+    "me.com",
+    "mac.com",
+    "protonmail.com",
+    "pm.me",
+    "fastmail.com",
+    "hey.com",
+    "aol.com",
+    "msn.com"
+  ]);
+  if (genericDomains.has(domain.toLowerCase()))
+    return null;
+  const parts = domain.split(".");
+  const name = parts.length > 2 ? parts[parts.length - 2] : parts[0];
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function parseName(displayName) {
+  const name = displayName.trim();
+  if (!name)
+    return {};
+  const parts = name.split(/\s+/);
+  if (parts.length === 1)
+    return { first_name: parts[0] };
+  const last = parts.pop();
+  return { first_name: parts.join(" "), last_name: last };
+}
+async function extractContactsFromGmail(opts) {
+  const maxMessages = Math.min(opts.max_messages ?? 200, 500);
+  const profile = opts.gmail_profile ?? "default";
+  let token;
+  try {
+    const tokens = readConnectorTokens("gmail", profile);
+    token = tokens["accessToken"];
+    if (!token)
+      throw new ConnectorAuthError("gmail", "accessToken missing");
+  } catch (err) {
+    if (err instanceof ConnectorAuthError)
+      throw err;
+    throw new ConnectorAuthError("gmail", String(err));
+  }
+  const listUrl = new URL("https://gmail.googleapis.com/gmail/v1/users/me/messages");
+  listUrl.searchParams.set("q", opts.query);
+  listUrl.searchParams.set("maxResults", String(maxMessages));
+  const listResp = await fetch(listUrl.toString(), {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (!listResp.ok) {
+    if (listResp.status === 401) {
+      throw new ConnectorAuthError("gmail", "token expired \u2014 run connect-gmail auth login");
+    }
+    throw new Error(`Gmail API error ${listResp.status}: ${await listResp.text()}`);
+  }
+  const listData = await listResp.json();
+  const messageRefs = listData.messages ?? [];
+  if (messageRefs.length === 0)
+    return [];
+  const seen = new Map;
+  const batchSize = 20;
+  for (let i = 0;i < messageRefs.length; i += batchSize) {
+    const batch = messageRefs.slice(i, i + batchSize);
+    const fetches = batch.map((ref) => {
+      const url = new URL(`https://gmail.googleapis.com/gmail/v1/users/me/messages/${ref.id}`);
+      url.searchParams.set("format", "metadata");
+      url.searchParams.append("metadataHeaders", "From");
+      url.searchParams.append("metadataHeaders", "To");
+      url.searchParams.append("metadataHeaders", "Cc");
+      return fetch(url.toString(), {
+        headers: { Authorization: `Bearer ${token}` }
+      }).then((r) => r.ok ? r.json() : null);
+    });
+    const results = await Promise.all(fetches);
+    for (const msg of results) {
+      if (!msg?.payload?.headers)
+        continue;
+      const getHeader = (name) => msg.payload.headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? "";
+      const addresses = [
+        ...parseAddressHeader(getHeader("From")),
+        ...parseAddressHeader(getHeader("To")),
+        ...parseAddressHeader(getHeader("Cc"))
+      ];
+      for (const { name, email } of addresses) {
+        if (seen.has(email))
+          continue;
+        const company_hint = domainToCompany(email);
+        const nameParts = parseName(name);
+        const contact_input = {
+          ...nameParts,
+          display_name: name || email.split("@")[0],
+          emails: [{ address: email, type: "work", is_primary: true }],
+          ...opts.tag_ids?.length ? { tag_ids: opts.tag_ids } : {},
+          source: "email"
+        };
+        seen.set(email, { email, name, company_hint, contact_input });
+      }
+    }
+  }
+  return Array.from(seen.values());
+}
+// src/lib/google-contacts.ts
+function googlePersonToContactInput(person) {
+  const name = person.names?.[0];
+  const primaryEmail = person.emailAddresses?.[0]?.value;
+  const nameParts = name?.givenName || name?.familyName ? { first_name: name.givenName, last_name: name.familyName } : primaryEmail ? parseName(name?.displayName ?? primaryEmail.split("@")[0] ?? "") : {};
+  const emails = (person.emailAddresses ?? []).filter((e) => e.value).map((e, i) => ({
+    address: e.value.toLowerCase(),
+    type: normalizeEmailType(e.type),
+    is_primary: i === 0
+  }));
+  const phones = (person.phoneNumbers ?? []).filter((p) => p.value).map((p, i) => ({
+    number: p.value,
+    type: normalizePhoneType(p.type),
+    is_primary: i === 0
+  }));
+  const org = person.organizations?.[0];
+  const website = person.urls?.[0]?.value;
+  const birthday = (() => {
+    const b = person.birthdays?.[0]?.date;
+    if (!b?.year || !b?.month || !b?.day)
+      return;
+    const mm = String(b.month).padStart(2, "0");
+    const dd = String(b.day).padStart(2, "0");
+    return `${b.year}-${mm}-${dd}`;
+  })();
+  const notes = person.biographies?.map((b) => b.value).filter(Boolean).join(`
+
+`) || undefined;
+  return {
+    ...nameParts,
+    display_name: name?.displayName ?? (nameParts.first_name ? `${nameParts.first_name} ${nameParts.last_name ?? ""}`.trim() : primaryEmail?.split("@")[0] ?? "Unknown"),
+    job_title: org?.title,
+    notes,
+    birthday,
+    website,
+    source: "import",
+    emails,
+    phones,
+    custom_fields: { google_resource_name: person.resourceName }
+  };
+}
+function normalizeEmailType(type) {
+  if (!type)
+    return "work";
+  const t = type.toLowerCase();
+  if (t === "work" || t === "home" || t === "personal")
+    return t === "home" ? "personal" : "work";
+  return "other";
+}
+function normalizePhoneType(type) {
+  if (!type)
+    return "mobile";
+  const t = type.toLowerCase();
+  if (t === "mobile" || t === "cell")
+    return "mobile";
+  if (t === "work")
+    return "work";
+  if (t === "home")
+    return "home";
+  if (t === "fax")
+    return "fax";
+  return "other";
+}
+function contactToGoogleArgs(contact) {
+  const args = [];
+  const displayName = contact.display_name;
+  if (displayName)
+    args.push("--name", displayName);
+  if (contact.first_name)
+    args.push("--given-name", contact.first_name);
+  if (contact.last_name)
+    args.push("--family-name", contact.last_name);
+  const primaryEmail = contact.emails.find((e) => e.is_primary) ?? contact.emails[0];
+  if (primaryEmail)
+    args.push("--email", primaryEmail.address);
+  const primaryPhone = contact.phones.find((p) => p.is_primary) ?? contact.phones[0];
+  if (primaryPhone)
+    args.push("--phone", primaryPhone.number);
+  if (contact.job_title)
+    args.push("--title", contact.job_title);
+  if (contact.company)
+    args.push("--company", contact.company.name);
+  if (contact.notes)
+    args.push("--notes", contact.notes);
+  if (contact.website)
+    args.push("--url", contact.website);
+  return args;
+}
+async function listGoogleContacts(opts = {}) {
+  const args = ["contacts", "list"];
+  if (opts.page_size)
+    args.push("--page-size", String(opts.page_size));
+  const raw = await runConnector("googlecontacts", args, opts);
+  return normalizeGoogleContactsResponse(raw);
+}
+async function searchGoogleContacts(query, opts = {}) {
+  const raw = await runConnector("googlecontacts", ["contacts", "search", query], opts);
+  return normalizeGoogleContactsResponse(raw);
+}
+function normalizeGoogleContactsResponse(raw) {
+  if (!raw)
+    return [];
+  if (Array.isArray(raw))
+    return raw;
+  const obj = raw;
+  if (Array.isArray(obj["connections"]))
+    return obj["connections"];
+  if (Array.isArray(obj["contacts"]))
+    return obj["contacts"];
+  return [];
+}
+async function pushContactToGoogle(contact, opts = {}) {
+  const googleResourceName = contact.custom_fields?.["google_resource_name"];
+  if (googleResourceName && opts.update_existing) {
+    const args2 = ["contacts", "update", googleResourceName, ...contactToGoogleArgs(contact)];
+    const result2 = await runConnector("googlecontacts", args2, opts);
+    return { resourceName: result2?.resourceName ?? googleResourceName, action: "updated" };
+  }
+  const args = ["contacts", "create", ...contactToGoogleArgs(contact)];
+  const result = await runConnector("googlecontacts", args, opts);
+  return { resourceName: result?.resourceName ?? "", action: "created" };
+}
+async function pullGoogleContactsAsInputs(opts = {}) {
+  const people = opts.query ? await searchGoogleContacts(opts.query, opts) : await listGoogleContacts(opts);
+  return people.filter((p) => p.emailAddresses?.some((e) => e.value)).map(googlePersonToContactInput);
+}
 export {
   updateTag,
   updateGroup,
@@ -1319,13 +1667,20 @@ export {
   updateCompany,
   unarchiveContact,
   unarchiveCompany,
+  searchGoogleContacts,
   searchContacts,
   searchCompanies,
+  runConnector,
   resetDatabase,
   removeTagFromContact,
   removeTagFromCompany,
   removeContactFromGroup,
   removeCompanyFromGroup,
+  readConnectorTokens,
+  pushContactToGoogle,
+  pullGoogleContactsAsInputs,
+  parseName,
+  parseAddressHeader,
   mergeContacts,
   logActivity,
   listTags,
@@ -1334,6 +1689,7 @@ export {
   listGroupsForContact,
   listGroupsForCompany,
   listGroups,
+  listGoogleContacts,
   listContactsInGroup,
   listContactsByTag,
   listContacts,
@@ -1341,6 +1697,7 @@ export {
   listCompaniesInGroup,
   listCompanies,
   listActivity,
+  googlePersonToContactInput,
   getTagByName,
   getTag,
   getRelationship,
@@ -1348,8 +1705,11 @@ export {
   getDatabase,
   getContactByEmail,
   getContact,
+  getConnectorTokenPath,
   getCompany,
   getActivity,
+  extractContactsFromGmail,
+  domainToCompany,
   deleteTag,
   deleteRelationship,
   deleteGroup,
@@ -1360,6 +1720,7 @@ export {
   createGroup,
   createContact,
   createCompany,
+  contactToGoogleArgs,
   autoLinkContactToCompany,
   archiveContact,
   archiveCompany,
@@ -1372,5 +1733,7 @@ export {
   TagNotFoundError,
   DuplicateTagNameError,
   ContactNotFoundError,
+  ConnectorNotInstalledError,
+  ConnectorAuthError,
   CompanyNotFoundError
 };

package/dist/lib/google-contacts.test.d.ts

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

package/dist/lib/google-contacts.test.d.ts.map

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

package/dist/mcp/index.js

@@ -1777,6 +1777,16 @@ async function exportContacts(format, contacts) {
 import { join as join2 } from "path";
 import { existsSync as existsSync2, readFileSync } from "fs";
 import { homedir } from "os";
+
+class ConnectorNotInstalledError extends Error {
+  connectorName;
+  constructor(connectorName) {
+    super(`connect-${connectorName} is not installed. ` + `Run: bun install -g @hasnaxyz/connect-${connectorName}`);
+    this.connectorName = connectorName;
+    this.name = "ConnectorNotInstalledError";
+  }
+}
+
 class ConnectorAuthError extends Error {
   connectorName;
   constructor(connectorName, detail) {
@@ -1785,6 +1795,53 @@ class ConnectorAuthError extends Error {
     this.name = "ConnectorAuthError";
   }
 }
+async function runConnector(name, args, opts = {}) {
+  const binary = `connect-${name}`;
+  const profile = opts.profile ?? "default";
+  const fullArgs = [
+    "--format",
+    "json",
+    "--profile",
+    profile,
+    ...args
+  ];
+  let proc;
+  try {
+    proc = Bun.spawn([binary, ...fullArgs], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("not found") || msg.includes("ENOENT")) {
+      throw new ConnectorNotInstalledError(name);
+    }
+    throw err;
+  }
+  const timeoutMs = opts.timeout ?? 30000;
+  const timer = setTimeout(() => proc.kill(), timeoutMs);
+  try {
+    const [stdout, stderr, exitCode] = await Promise.all([
+      proc.stdout ? new Response(proc.stdout).text() : Promise.resolve(""),
+      proc.stderr ? new Response(proc.stderr).text() : Promise.resolve(""),
+      proc.exited
+    ]);
+    if (exitCode !== 0) {
+      const errText = (stderr || stdout).trim();
+      const lower = errText.toLowerCase();
+      if (lower.includes("auth") || lower.includes("token") || lower.includes("401") || lower.includes("unauthorized") || lower.includes("not authenticated")) {
+        throw new ConnectorAuthError(name, errText.slice(0, 200));
+      }
+      throw new Error(`connect-${name} exited ${exitCode}: ${errText.slice(0, 400)}`);
+    }
+    const text = stdout.trim();
+    if (!text || text === "null")
+      return null;
+    return JSON.parse(text);
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function getConnectorTokenPath(name, profile = "default") {
   const bases = [
     join2(homedir(), ".connectors", `connect-${name}`, "profiles", profile, "tokens.json"),
@@ -1940,6 +1997,133 @@ async function extractContactsFromGmail(opts) {
   return Array.from(seen.values());
 }
 
+// src/lib/google-contacts.ts
+function googlePersonToContactInput(person) {
+  const name = person.names?.[0];
+  const primaryEmail = person.emailAddresses?.[0]?.value;
+  const nameParts = name?.givenName || name?.familyName ? { first_name: name.givenName, last_name: name.familyName } : primaryEmail ? parseName(name?.displayName ?? primaryEmail.split("@")[0] ?? "") : {};
+  const emails = (person.emailAddresses ?? []).filter((e) => e.value).map((e, i) => ({
+    address: e.value.toLowerCase(),
+    type: normalizeEmailType(e.type),
+    is_primary: i === 0
+  }));
+  const phones = (person.phoneNumbers ?? []).filter((p) => p.value).map((p, i) => ({
+    number: p.value,
+    type: normalizePhoneType(p.type),
+    is_primary: i === 0
+  }));
+  const org = person.organizations?.[0];
+  const website = person.urls?.[0]?.value;
+  const birthday = (() => {
+    const b = person.birthdays?.[0]?.date;
+    if (!b?.year || !b?.month || !b?.day)
+      return;
+    const mm = String(b.month).padStart(2, "0");
+    const dd = String(b.day).padStart(2, "0");
+    return `${b.year}-${mm}-${dd}`;
+  })();
+  const notes = person.biographies?.map((b) => b.value).filter(Boolean).join(`
+
+`) || undefined;
+  return {
+    ...nameParts,
+    display_name: name?.displayName ?? (nameParts.first_name ? `${nameParts.first_name} ${nameParts.last_name ?? ""}`.trim() : primaryEmail?.split("@")[0] ?? "Unknown"),
+    job_title: org?.title,
+    notes,
+    birthday,
+    website,
+    source: "import",
+    emails,
+    phones,
+    custom_fields: { google_resource_name: person.resourceName }
+  };
+}
+function normalizeEmailType(type) {
+  if (!type)
+    return "work";
+  const t = type.toLowerCase();
+  if (t === "work" || t === "home" || t === "personal")
+    return t === "home" ? "personal" : "work";
+  return "other";
+}
+function normalizePhoneType(type) {
+  if (!type)
+    return "mobile";
+  const t = type.toLowerCase();
+  if (t === "mobile" || t === "cell")
+    return "mobile";
+  if (t === "work")
+    return "work";
+  if (t === "home")
+    return "home";
+  if (t === "fax")
+    return "fax";
+  return "other";
+}
+function contactToGoogleArgs(contact) {
+  const args = [];
+  const displayName = contact.display_name;
+  if (displayName)
+    args.push("--name", displayName);
+  if (contact.first_name)
+    args.push("--given-name", contact.first_name);
+  if (contact.last_name)
+    args.push("--family-name", contact.last_name);
+  const primaryEmail = contact.emails.find((e) => e.is_primary) ?? contact.emails[0];
+  if (primaryEmail)
+    args.push("--email", primaryEmail.address);
+  const primaryPhone = contact.phones.find((p) => p.is_primary) ?? contact.phones[0];
+  if (primaryPhone)
+    args.push("--phone", primaryPhone.number);
+  if (contact.job_title)
+    args.push("--title", contact.job_title);
+  if (contact.company)
+    args.push("--company", contact.company.name);
+  if (contact.notes)
+    args.push("--notes", contact.notes);
+  if (contact.website)
+    args.push("--url", contact.website);
+  return args;
+}
+async function listGoogleContacts(opts = {}) {
+  const args = ["contacts", "list"];
+  if (opts.page_size)
+    args.push("--page-size", String(opts.page_size));
+  const raw = await runConnector("googlecontacts", args, opts);
+  return normalizeGoogleContactsResponse(raw);
+}
+async function searchGoogleContacts(query, opts = {}) {
+  const raw = await runConnector("googlecontacts", ["contacts", "search", query], opts);
+  return normalizeGoogleContactsResponse(raw);
+}
+function normalizeGoogleContactsResponse(raw) {
+  if (!raw)
+    return [];
+  if (Array.isArray(raw))
+    return raw;
+  const obj = raw;
+  if (Array.isArray(obj["connections"]))
+    return obj["connections"];
+  if (Array.isArray(obj["contacts"]))
+    return obj["contacts"];
+  return [];
+}
+async function pushContactToGoogle(contact, opts = {}) {
+  const googleResourceName = contact.custom_fields?.["google_resource_name"];
+  if (googleResourceName && opts.update_existing) {
+    const args2 = ["contacts", "update", googleResourceName, ...contactToGoogleArgs(contact)];
+    const result2 = await runConnector("googlecontacts", args2, opts);
+    return { resourceName: result2?.resourceName ?? googleResourceName, action: "updated" };
+  }
+  const args = ["contacts", "create", ...contactToGoogleArgs(contact)];
+  const result = await runConnector("googlecontacts", args, opts);
+  return { resourceName: result?.resourceName ?? "", action: "created" };
+}
+async function pullGoogleContactsAsInputs(opts = {}) {
+  const people = opts.query ? await searchGoogleContacts(opts.query, opts) : await listGoogleContacts(opts);
+  return people.filter((p) => p.emailAddresses?.some((e) => e.value)).map(googlePersonToContactInput);
+}
+
 // src/mcp/index.ts
 var server = new Server({ name: "contacts", version: "0.1.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -2754,6 +2938,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         required: ["query"]
       }
+    },
+    {
+      name: "sync_from_google_contacts",
+      description: "Pull contacts from Google Contacts (People API) and upsert them into the local database. Skips contacts that already exist by email. Requires connect-googlecontacts auth login. Returns { imported, skipped, errors }.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Optional search query to filter which Google Contacts to import" },
+          page_size: { type: "number", description: "Contacts per page (default: connector default)" },
+          google_profile: { type: "string", description: "connect-googlecontacts profile (default: 'default')" },
+          tag_ids: { type: "array", items: { type: "string" }, description: "Tag IDs to apply to all imported contacts" },
+          project_id: { type: "string", description: "Project ID to assign to all imported contacts" },
+          dry_run: { type: "boolean", description: "Preview what would be imported without saving" }
+        }
+      }
+    },
+    {
+      name: "push_contact_to_google",
+      description: "Push a local contact to Google Contacts \u2014 creates a new Google contact (or updates if google_resource_name is stored in custom_fields). Requires connect-googlecontacts auth login.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          contact_id: { type: "string", description: "Local contact ID to push" },
+          google_profile: { type: "string", description: "connect-googlecontacts profile (default: 'default')" },
+          update_existing: { type: "boolean", description: "If true, update existing Google contact when google_resource_name is present in custom_fields" }
+        },
+        required: ["contact_id"]
+      }
+    },
+    {
+      name: "search_google_contacts",
+      description: "Search Google Contacts by name or email (read-only, does not import). Returns raw Google People API objects. Useful for lookup or preview before a push/sync.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string" },
+          google_profile: { type: "string", description: "connect-googlecontacts profile (default: 'default')" }
+        },
+        required: ["query"]
+      }
     }
   ]
 }));
@@ -3384,14 +3608,79 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }]
         };
       }
+      case "sync_from_google_contacts": {
+        const db = getDatabase();
+        const googleProfile = a.google_profile;
+        const inputs = await pullGoogleContactsAsInputs({
+          query: a.query,
+          page_size: a.page_size,
+          profile: googleProfile ?? "default"
+        });
+        const enriched = inputs.map((inp) => ({
+          ...inp,
+          ...a.tag_ids ? { tag_ids: a.tag_ids } : {},
+          ...a.project_id ? { project_id: a.project_id } : {}
+        }));
+        if (a.dry_run) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({ dry_run: true, would_import: enriched.length, contacts: enriched }, null, 2)
+            }]
+          };
+        }
+        let imported = 0;
+        let skipped = 0;
+        const syncErrors = [];
+        for (const input of enriched) {
+          const primaryEmail = input.emails?.[0]?.address;
+          if (!primaryEmail) {
+            skipped++;
+            continue;
+          }
+          try {
+            const existing = db.prepare(`SELECT contact_id FROM emails WHERE LOWER(address) = LOWER(?) AND contact_id IS NOT NULL LIMIT 1`).get(primaryEmail);
+            if (existing) {
+              skipped++;
+              continue;
+            }
+            createContact(input);
+            imported++;
+          } catch (err) {
+            syncErrors.push(`${primaryEmail}: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ imported, skipped, errors: syncErrors.length, error_details: syncErrors }, null, 2)
+          }]
+        };
+      }
+      case "push_contact_to_google": {
+        const contact = getContact(a.contact_id);
+        const result = await pushContactToGoogle(contact, {
+          profile: a.google_profile ?? "default",
+          update_existing: a.update_existing
+        });
+        return { content: [{ type: "text", text: JSON.stringify({ ...result, contact_id: contact.id }, null, 2) }] };
+      }
+      case "search_google_contacts": {
+        const people = await searchGoogleContacts(a.query, {
+          profile: a.google_profile ?? "default"
+        });
+        const mapped = people.map((p) => ({
+          google: p,
+          as_contact_input: googlePersonToContactInput(p)
+        }));
+        return { content: [{ type: "text", text: JSON.stringify(mapped, null, 2) }] };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
   } catch (err) {
-    return {
-      content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
-      isError: true
-    };
+    const msg = err instanceof ConnectorNotInstalledError || err instanceof ConnectorAuthError ? err.message : `Error: ${err instanceof Error ? err.message : String(err)}`;
+    return { content: [{ type: "text", text: msg }], isError: true };
   }
 });
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/contacts",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Contact management for AI coding agents — CLI + MCP + Web",
   "type": "module",
   "main": "dist/index.js",