@dench.com/cli 0.4.8 → 2.0.0

package/crm.ts

@@ -48,11 +48,21 @@ import {
   type FieldCandidate,
 } from "./lib/crm-enrichment";
 import {
+  aviatoEnrichCompany,
+  aviatoEnrichPerson,
   enrichCompany,
   EnrichmentGatewayError,
   enrichPersonByIdentifier,
 } from "./lib/enrichment-gateway";
 
+// Contact-info fields that Aviato does not return.
+const CONTACT_REQUIRED_FIELDS = ["phone", "email", "personal_email"] as const;
+type ContactRequiredField = (typeof CONTACT_REQUIRED_FIELDS)[number];
+
+function isContactField(field: string): field is ContactRequiredField {
+  return (CONTACT_REQUIRED_FIELDS as readonly string[]).includes(field);
+}
+
 type JsonRecord = Record<string, unknown>;
 
 const CRM_BATCH_CHUNK_SIZE = 200;
@@ -688,8 +698,32 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
     case "list": {
       const objectName = shift(ctx.args, "object name");
       const limit = parseInt(getFlag(ctx.args, "--limit") ?? "100", 10);
+      const withMeta = hasFlag(ctx.args, "--with-meta");
       assertNoUnknownFlags(ctx.args, "crm entries list");
-      out(ctx, await callQuery(ctx, api.entries.list, { objectName, limit }));
+      const entries = await callQuery(ctx, api.entries.list, {
+        objectName,
+        limit,
+      });
+      if (!withMeta) {
+        out(ctx, entries);
+        return;
+      }
+      const object = (await callQuery(ctx, api.objects.get, {
+        name: objectName,
+      })) as { entryCount?: number } | null;
+      const returnedCount = Array.isArray(entries) ? entries.length : 0;
+      const totalCount =
+        typeof object?.entryCount === "number"
+          ? object.entryCount
+          : returnedCount;
+      out(ctx, {
+        objectName,
+        totalCount,
+        returnedCount,
+        limit,
+        hasMore: totalCount > returnedCount,
+        entries,
+      });
       return;
     }
     case "get": {
@@ -1657,6 +1691,8 @@ async function resolveEnrichmentTarget(
 async function callEnrichmentGatewayForEntry(args: {
   target: EnrichmentTarget;
   entry: CrmEntryForEnrichment;
+  /** Explicit provider override. Defaults: people=fullenrich, company=aviato. */
+  provider?: string;
 }): Promise<Record<string, unknown>> {
   const input = args.entry.fields[args.target.inputField.name];
   if (!hasCellValue(input)) {
@@ -1665,13 +1701,42 @@ async function callEnrichmentGatewayForEntry(args: {
     );
   }
   const inputValue = String(input);
-  if (args.target.category === "people") {
-    return await enrichPersonByIdentifier(inputValue, args.target.requiredFields);
+  const isCompany = args.target.category === "company";
+  const resolvedProvider = args.provider ?? (isCompany ? "aviato" : "fullenrich");
+
+  if (resolvedProvider === "aviato") {
+    // Guard: Aviato does not return phone or email.
+    const contactFields = args.target.requiredFields.filter(isContactField);
+    if (contactFields.length > 0) {
+      throw new CrmCliError(
+        `Aviato does not return phone or email; use --provider fullenrich for contact fields (${contactFields.join(", ")}).`,
+      );
+    }
+
+    if (isCompany) {
+      // inputValue is typically a domain; try to detect linkedin URLs
+      const isLinkedin = /linkedin\.com/i.test(inputValue);
+      return aviatoEnrichCompany(
+        isLinkedin ? { linkedinUrl: inputValue } : { website: inputValue },
+      );
+    } else {
+      // For people, inputValue may be a LinkedIn URL, email, or LinkedIn ID
+      const isLinkedin = /linkedin\.com/i.test(inputValue);
+      const isEmail = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(inputValue);
+      if (isLinkedin) return aviatoEnrichPerson({ linkedinUrl: inputValue });
+      if (isEmail) return aviatoEnrichPerson({ email: inputValue });
+      return aviatoEnrichPerson({ linkedinID: inputValue });
+    }
   }
-  return await enrichCompany({
-    domain: inputValue,
-    requiredFields: args.target.requiredFields,
-  });
+
+  // fullenrich path (default for people, explicit override for companies)
+  if (isCompany) {
+    return enrichCompany({
+      domain: inputValue,
+      requiredFields: args.target.requiredFields,
+    });
+  }
+  return enrichPersonByIdentifier(inputValue, args.target.requiredFields);
 }
 
 async function enrichOneEntry(
@@ -1685,6 +1750,7 @@ async function enrichOneEntry(
     const payload = await callEnrichmentGatewayForEntry({
       target: args.target,
       entry: args.entry,
+      provider: args.provider,
     });
     const value = extractEnrichmentValue(payload, args.target.column);
     if (value === null) {
@@ -2049,7 +2115,7 @@ Fields (columns):
   dench crm fields reorder <object> <field1> <field2> <field3> ...
 
 Entries (rows):
-  dench crm entries list <object> [--limit N] [--json]
+  dench crm entries list <object> [--limit N] [--with-meta] [--json]
   dench crm entries get <object> <entryId>
   dench crm entries create <object> --data '{"Field":"Value",...}'    (alias: --fields)
   dench crm entries create-many <object> --data '[{"Field":"Value",...}]' [--file rows.json] [--idempotency-key <key>]