@dench.com/cli 0.4.9 → 2.0.1

package/README.md

@@ -23,7 +23,7 @@ dench login --name "AI Agent - Billing Repo"
 to lowercase snake_case before send (e.g. `--kind "Claude Code"` becomes
 `claude_code`).
 
-The default backend is `https://dench.dev` (production). Use `dench backend`
+The default backend is `https://dench.com` (production). Use `dench backend`
 to switch:
 
 ```bash

package/crm.ts

@@ -26,7 +26,7 @@
  *   crm docs      list / create / link
  *   crm actions   list / run / runs
  */
-import { ConvexHttpClient } from "convex/browser";
+import type { ConvexHttpClient } from "convex/browser";
 import { makeFunctionReference } from "convex/server";
 import {
   assertNoUnknownFlags as assertNoUnknownFlagsRaw,
@@ -40,18 +40,19 @@ import {
 import {
   autoDetectInputField,
   detectEnrichmentCategory,
-  extractEnrichmentValue,
-  findEnrichmentColumn,
-  getRequiredFieldsForApolloPath,
   type EnrichmentCategory,
   type EnrichmentColumnDef,
+  extractEnrichmentValue,
   type FieldCandidate,
+  findEnrichmentColumn,
+  getRequiredFieldsForApolloPath,
 } from "./lib/crm-enrichment";
 import {
   aviatoEnrichCompany,
   aviatoEnrichPerson,
-  enrichCompany,
   EnrichmentGatewayError,
+  type EnrichmentGatewayOptions,
+  enrichCompany,
   enrichPersonByIdentifier,
 } from "./lib/enrichment-gateway";
 
@@ -82,6 +83,7 @@ type CrmCliContext = {
    * organization context.
    */
   sessionToken?: string;
+  enrichmentGateway?: Pick<EnrichmentGatewayOptions, "apiKey" | "baseUrl">;
 };
 
 // Adapt the shared helpers to throw CrmCliError so existing call sites
@@ -310,12 +312,14 @@ function out(ctx: CrmCliContext, value: unknown): void {
   console.log(JSON.stringify(value, null, 2));
 }
 
-function getFieldEnrichmentFlag(args: string[]): {
-  category: EnrichmentCategory;
-  key: string;
-  apolloPath: string;
-  inputFieldName: string;
-} | undefined {
+function getFieldEnrichmentFlag(args: string[]):
+  | {
+      category: EnrichmentCategory;
+      key: string;
+      apolloPath: string;
+      inputFieldName: string;
+    }
+  | undefined {
   const category = parseCategoryFlag(getFlag(args, "--enrichment-category"));
   const key = getFlag(args, "--enrichment-key");
   const apolloPath = getFlag(args, "--apollo-path");
@@ -431,6 +435,7 @@ export async function runCrmCommand(opts: {
   convex: ConvexHttpClient;
   args: string[];
   sessionToken?: string;
+  enrichmentGateway?: Pick<EnrichmentGatewayOptions, "apiKey" | "baseUrl">;
 }): Promise<void> {
   const args = [...opts.args];
   const jsonOutput = hasFlag(args, "--json");
@@ -439,6 +444,7 @@ export async function runCrmCommand(opts: {
     args,
     jsonOutput,
     sessionToken: opts.sessionToken,
+    enrichmentGateway: opts.enrichmentGateway,
   };
   const subcommand = args.shift();
   if (!subcommand || subcommand === "help" || subcommand === "--help") {
@@ -1531,13 +1537,18 @@ type ObjectEnrichmentArgs = Omit<CellEnrichmentArgs, "entryId"> & {
   limit?: number;
 };
 
-function parseCategoryFlag(value: string | undefined): EnrichmentCategory | undefined {
+function parseCategoryFlag(
+  value: string | undefined,
+): EnrichmentCategory | undefined {
   if (value === undefined) return undefined;
   if (value === "people" || value === "company") return value;
   throw new CrmCliError("--category must be people or company");
 }
 
-function parsePositiveInt(flag: string, value: string | undefined): number | undefined {
+function parsePositiveInt(
+  flag: string,
+  value: string | undefined,
+): number | undefined {
   if (value === undefined) return undefined;
   const parsed = Number(value);
   if (!Number.isInteger(parsed) || parsed < 1) {
@@ -1556,7 +1567,9 @@ function asFields(value: unknown): CrmFieldForEnrichment[] {
     .filter((field): field is CrmFieldForEnrichment => {
       if (!field || typeof field !== "object") return false;
       const candidate = field as Record<string, unknown>;
-      return typeof candidate.name === "string" && typeof candidate.type === "string";
+      return (
+        typeof candidate.name === "string" && typeof candidate.type === "string"
+      );
     })
     .map((field) => ({
       id: typeof field.id === "string" ? field.id : undefined,
@@ -1601,7 +1614,9 @@ function asEntry(value: unknown): CrmEntryForEnrichment | null {
 
 function asEntries(value: unknown): CrmEntryForEnrichment[] {
   if (!Array.isArray(value)) return [];
-  return value.map(asEntry).filter((entry): entry is CrmEntryForEnrichment => !!entry);
+  return value
+    .map(asEntry)
+    .filter((entry): entry is CrmEntryForEnrichment => !!entry);
 }
 
 function resolveEnrichmentColumn(args: {
@@ -1668,7 +1683,8 @@ async function resolveEnrichmentTarget(
     apolloPath: args.apolloPath ?? outputField.enrichment?.apolloPath,
   });
 
-  const inputFieldName = args.inputFieldName ?? outputField.enrichment?.inputFieldName;
+  const inputFieldName =
+    args.inputFieldName ?? outputField.enrichment?.inputFieldName;
   const inputField = inputFieldName
     ? fields.find((field) => field.name === inputFieldName)
     : autoDetectInputField(category, fields);
@@ -1693,6 +1709,7 @@ async function callEnrichmentGatewayForEntry(args: {
   entry: CrmEntryForEnrichment;
   /** Explicit provider override. Defaults: people=fullenrich, company=aviato. */
   provider?: string;
+  gateway?: Pick<EnrichmentGatewayOptions, "apiKey" | "baseUrl">;
 }): Promise<Record<string, unknown>> {
   const input = args.entry.fields[args.target.inputField.name];
   if (!hasCellValue(input)) {
@@ -1702,7 +1719,8 @@ async function callEnrichmentGatewayForEntry(args: {
   }
   const inputValue = String(input);
   const isCompany = args.target.category === "company";
-  const resolvedProvider = args.provider ?? (isCompany ? "aviato" : "fullenrich");
+  const resolvedProvider =
+    args.provider ?? (isCompany ? "aviato" : "fullenrich");
 
   if (resolvedProvider === "aviato") {
     // Guard: Aviato does not return phone or email.
@@ -1718,25 +1736,37 @@ async function callEnrichmentGatewayForEntry(args: {
       const isLinkedin = /linkedin\.com/i.test(inputValue);
       return aviatoEnrichCompany(
         isLinkedin ? { linkedinUrl: inputValue } : { website: inputValue },
+        args.gateway,
       );
     } 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 });
+      if (isLinkedin) {
+        return aviatoEnrichPerson({ linkedinUrl: inputValue }, args.gateway);
+      }
+      if (isEmail) {
+        return aviatoEnrichPerson({ email: inputValue }, args.gateway);
+      }
+      return aviatoEnrichPerson({ linkedinID: inputValue }, args.gateway);
     }
   }
 
   // fullenrich path (default for people, explicit override for companies)
   if (isCompany) {
-    return enrichCompany({
-      domain: inputValue,
-      requiredFields: args.target.requiredFields,
-    });
+    return enrichCompany(
+      {
+        domain: inputValue,
+        requiredFields: args.target.requiredFields,
+      },
+      args.gateway,
+    );
   }
-  return enrichPersonByIdentifier(inputValue, args.target.requiredFields);
+  return enrichPersonByIdentifier(
+    inputValue,
+    args.target.requiredFields,
+    args.gateway,
+  );
 }
 
 async function enrichOneEntry(
@@ -1751,6 +1781,7 @@ async function enrichOneEntry(
       target: args.target,
       entry: args.entry,
       provider: args.provider,
+      gateway: ctx.enrichmentGateway,
     });
     const value = extractEnrichmentValue(payload, args.target.column);
     if (value === null) {
@@ -1779,7 +1810,10 @@ async function enrichOneEntry(
       ...writeResult,
     };
   } catch (error) {
-    if (error instanceof EnrichmentGatewayError || error instanceof CrmCliError) {
+    if (
+      error instanceof EnrichmentGatewayError ||
+      error instanceof CrmCliError
+    ) {
       return {
         entryId: args.entry.id,
         ok: false,