higherdata 0.2.0 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@ node packages/cli/dist/index.js --version
 node packages/cli/dist/index.js --help
 ```
 
-The package provides `higherdata` and `hd`. After the first approved npm release,
+The package provides the `higherdata` command. After the first approved npm release,
 install with `npm install --global higherdata`, or run `npx higherdata --version`.
 Global flags are `--json`, `--jsonl` and `--api-url <url>`.
 `--help` and `--version` work without credentials or a config file.
@@ -39,7 +39,7 @@ Exit codes: 0 success, 2 usage or configuration, 3 authentication, 4 limit,
 
 ## Interactive app
 
-Run `higherdata` (or `hd`) in a terminal to open the keyboard app. The yellow
+Run `higherdata` in a terminal to open the keyboard app. The yellow
 wordmark and three bars form in under 1.5 seconds; any key skips it.
 `--no-banner` opens the menu immediately. Piped output, `--json`, `--jsonl`
 and `CI` never animate. `NO_COLOR` disables accent colors. Supports 80 columns

package/dist/index.js

@@ -25483,9 +25483,33 @@ var init_generated = __esm({
           ]
         }
       },
+      {
+        "name": "lookup.find",
+        "description": "Direct lookup by email, international phone, website, LinkedIn profile, opaque record id or name. Names match companies, people and this space's own lists. Optional person-name company hints use 'at Company' or a trailing domain. Returns at most 20 suppressed-safe matches. Execute only after the user submits a lookup.",
+        "risk": "read",
+        "scopes": [
+          "data:read"
+        ],
+        "input": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object",
+          "properties": {
+            "query": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2048,
+              "description": "Name, work email, international phone, website, LinkedIn profile or opaque record id to find."
+            }
+          },
+          "required": [
+            "query"
+          ],
+          "additionalProperties": false
+        }
+      },
       {
         "name": "lookup.person",
-        "description": "Look up a person by exactly one work email, LinkedIn profile URL or opaque hdp_ id. LinkedIn and id matching include people without email. ",
+        "description": "Look up a person by exactly one work email, international phone, exact or prefix name, LinkedIn profile URL or opaque hdp_ id. Names may be narrowed by company name or domain. Matching includes people without email or a current company. ",
         "risk": "read",
         "scopes": [
           "data:read"
@@ -25522,6 +25546,73 @@ var init_generated = __esm({
               ],
               "additionalProperties": false
             },
+            {
+              "type": "object",
+              "properties": {
+                "phone": {
+                  "type": "string",
+                  "maxLength": 512,
+                  "description": "International phone number including its country code."
+                },
+                "candidateLimit": {
+                  "default": 5,
+                  "description": "Maximum candidates to return.",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "excludeListId": {
+                  "description": "Saved list whose members are left out of the result.",
+                  "type": "string",
+                  "format": "uuid",
+                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                }
+              },
+              "required": [
+                "phone"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 240,
+                  "description": "Exact or prefix person name."
+                },
+                "companyName": {
+                  "description": "Company name to narrow the person name match.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 240
+                },
+                "companyDomain": {
+                  "description": "Company domain to narrow the person name match.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 320
+                },
+                "candidateLimit": {
+                  "default": 20,
+                  "description": "Maximum name candidates, ranked by exact match then priority.",
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 20
+                },
+                "excludeListId": {
+                  "description": "Saved list whose members are left out of the result.",
+                  "type": "string",
+                  "format": "uuid",
+                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                }
+              },
+              "required": [
+                "name"
+              ],
+              "additionalProperties": false
+            },
             {
               "type": "object",
               "properties": {
@@ -31823,11 +31914,10 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "higherdata",
-      version: "0.2.0",
+      version: "0.2.2",
       type: "module",
       bin: {
-        higherdata: "dist/index.js",
-        hd: "dist/index.js"
+        higherdata: "dist/index.js"
       },
       files: [
         "dist",
@@ -33693,6 +33783,13 @@ var init_records = __esm({
   }
 });
 
+// ../../src/lib/lookup/phone.ts
+var init_phone = __esm({
+  "../../src/lib/lookup/phone.ts"() {
+    "use strict";
+  }
+});
+
 // ../../node_modules/tldts-core/dist/es6/src/domain.js
 var init_domain = __esm({
   "../../node_modules/tldts-core/dist/es6/src/domain.js"() {
@@ -34460,6 +34557,7 @@ var suppressionKeyTypeSchema;
 var init_normalize = __esm({
   "../../src/lib/suppression/normalize.ts"() {
     "use strict";
+    init_phone();
     init_es62();
     init_zod();
     init_email();
@@ -37858,7 +37956,7 @@ function shownValue(value) {
   return clean(value);
 }
 function rowsOf(result) {
-  for (const name of ["items", "candidates", "searches", "lists", "groups", "orphans", "gaps", "records", "connections", "keys", "runs", "proposals"]) {
+  for (const name of ["items", "candidates", "matches", "searches", "lists", "groups", "orphans", "gaps", "records", "connections", "keys", "runs", "proposals"]) {
     if (Array.isArray(result[name]) && result[name].length) return result[name].filter((row) => row && typeof row === "object");
   }
   return [];
@@ -38734,7 +38832,7 @@ var init_app = __esm({
           const result = await this.call(id.startsWith("hdo_") ? "lookup.company" : "lookup.person", { id });
           return { screen: "detail", row: rowsOf(result)[0] ?? result, selected: 0, tab: 0 };
         }
-        const next = state.tool?.name === "lists.get" && !state.input.id ? { name: "lists.get", input: { id: row.id } } : state.tool?.name === "jobs.list" ? { name: "jobs.get", input: { jobId: row.id } } : state.tool?.name === "changes.list" ? { name: "changes.get", input: { id: row.id } } : state.tool?.name === "crm.search" ? { name: "crm.get", input: { objectType: row.objectType ?? state.input.objectType, id: row.externalId ?? row.id } } : null;
+        const next = state.tool?.name === "lists.get" && !state.input.id || state.tool?.name === "lookup.find" && row.kind === "list" ? { name: "lists.get", input: { id: row.id } } : state.tool?.name === "jobs.list" ? { name: "jobs.get", input: { jobId: row.id } } : state.tool?.name === "changes.list" ? { name: "changes.get", input: { id: row.id } } : state.tool?.name === "crm.search" ? { name: "crm.get", input: { objectType: row.objectType ?? state.input.objectType, id: row.externalId ?? row.id } } : null;
         if (next) {
           const result = await this.call(next.name, next.input);
           return { screen: ["changes.get", "crm.get"].includes(next.name) ? "detail" : "results", tool: toolByName(next.name), input: next.input, result, row: result, selected: 0, tab: 0 };
@@ -39158,6 +39256,10 @@ function registerCommands(program2, runtime) {
     emit(await api.tool("search.count", await buildFilters(api, options, "companies")), mode);
   });
   const lookup = program2.command("lookup").description("Look up a company or person");
+  program2.command("find <query...>").description("Find companies, people and lists by name, email, phone, website, LinkedIn or record id").action(async (query, _options, command) => {
+    const { api, mode } = await session(command);
+    emit(await api.tool("lookup.find", { query: query.join(" ") }), mode);
+  });
   excludeList(lookup.command("company <domain>")).action(async (domain2, options, command) => {
     const { api, mode } = await session(command);
     emit(await api.tool("lookup.company", { domain: domain2, ...excluded(options) }), mode);

package/dist/suppression.js

@@ -2938,6 +2938,15 @@ function parsePhoneNumber4() {
   return withMetadataArgument(parsePhoneNumber3, arguments);
 }
 
+// ../../src/lib/lookup/phone.ts
+function normalizeLookupPhone(value) {
+  if (typeof value !== "string") return null;
+  const input2 = value.trim();
+  if (!input2 || input2.length > 512 || !/^\+[0-9() .-]+$/.test(input2)) return null;
+  const phone = parsePhoneNumber4(input2);
+  return phone?.isValid() ? phone.number : null;
+}
+
 // ../../node_modules/tldts-core/dist/es6/src/domain.js
 function shareSameDomainSuffix(hostname4, vhost) {
   if (hostname4.endsWith(vhost)) {
@@ -23486,10 +23495,9 @@ function normalizeSuppressionKey(keyType, value) {
       return `https://www.linkedin.com/in/${path[1].toLowerCase()}`;
     }
     case "phone_e164": {
-      if (!/^\+[0-9() .-]+$/.test(input2)) return invalid(keyType);
-      const phone = parsePhoneNumber4(input2);
-      if (!phone?.isValid()) return invalid(keyType);
-      return phone.number;
+      const phone = normalizeLookupPhone(input2);
+      if (!phone) return invalid(keyType);
+      return phone;
     }
   }
 }

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "higherdata",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "bin": {
-    "higherdata": "dist/index.js",
-    "hd": "dist/index.js"
+    "higherdata": "dist/index.js"
   },
   "files": [
     "dist",