import { PeopleClient } from "datafiniti-sdk";

const sdk = PeopleClient.fromEnv();

const response = await sdk.searchByName("Jane", "Smith", {
  city: "Seattle",
});

console.log("
=== NAME SEARCH TEST ===");
console.log("Matches:", response.num_found);

const records = response.records ?? [];

if (records.length) {
  const person = records[0];
  console.log("
Person:");
  console.log(person.name);
  console.log(person.firstName, person.lastName);
  console.log(person.city, person.province);
} else {
  console.log("No person found.");
}

import { PeopleClient } from "datafiniti-sdk";

const sdk = PeopleClient.fromEnv();

const count = await sdk.count('country:US AND lastName:"Smith"');

console.log("
=== COUNT TEST ===");
console.log(`People found: ${count.toLocaleString()}`);

import { PeopleClient } from "datafiniti-sdk";

const sdk = PeopleClient.fromEnv();

// Chain builder methods to assemble a query, then pass it to search.
const query = sdk
  .query()
  .country("US")
  .province("CA")
  .city("San Francisco")
  .lastName("Nguyen")
  .build();

const response = await sdk.search({ query, numRecords: 5 });

console.log("
=== LOCATION FILTER SEARCH ===");
console.log(`Total matches: ${(response.num_found ?? 0).toLocaleString()}`);

const records = response.records ?? [];

for (const person of records) {
  console.log(
    `
${person.name}` +
      ` — ${person.city}, ${person.province} ${person.postalCode}`
  );
}

import { PeopleClient } from "datafiniti-sdk";

const sdk = PeopleClient.fromEnv();

console.log("
=== PAGINATION TEST ===");

let recordsSeen = 0;

for await (const person of sdk.paginate({
  query: 'country:US AND province:"NY"',
  pageSize: 100,
  maxRecords: 250,
})) {
  recordsSeen += 1;
  console.log(`${recordsSeen}. ${person.name ?? "Unknown Name"}`);
}

console.log(`
Total Retrieved: ${recordsSeen}`);

/**
 * People Views Example: Contact Enrichment
 *
 * Uses a custom view to fetch only the fields needed to enrich a contact
 * list — phones and emails — for a set of known names. Requesting a narrow
 * view keeps responses small and fast when you only need contact details.
 *
 * Reference: https://docs.datafiniti.co/docs/using-a-custom-people-view
 */

import { PeopleClient, type DatafinitiRecord } from "datafiniti-sdk";

// ---------------------------------------------------------------------------
// View options
//
// OPTION 1 (used below): Custom inline view
//   Pass an array of field objects directly in the request. No setup required.
//
// OPTION 2: Premade (named) view — pass a string instead of an array.
//   "default"  All fields (same as omitting view entirely).
//   Example: sdk.search({ query, view: "default", numRecords: 10 })
//   Reference: https://docs.datafiniti.co/docs/people-data-views
// ---------------------------------------------------------------------------

const PEOPLE_VIEW = [
  { name: "name" },
  { name: "firstName" },
  { name: "lastName" },
  { name: "city" },
  { name: "province" },
  { name: "phones" },
  { name: "emails" },
];

function formatList(value: unknown): string {
  return Array.isArray(value) && value.length ? value.join(", ") : "N/A";
}

async function lookupContact(
  sdk: PeopleClient,
  firstName: string,
  lastName: string,
  city: string
): Promise<DatafinitiRecord | null> {
  const query = sdk
    .query()
    .firstName(firstName)
    .lastName(lastName)
    .city(city)
    .country("US")
    .build();

  const response = await sdk.search({ query, numRecords: 1, view: PEOPLE_VIEW });
  const records = response.records ?? [];
  return records.length ? records[0] : null;
}

async function main() {
  // Known contacts to enrich with phone and email data.
  const contacts = [
    { firstName: "Jane",  lastName: "Smith",   city: "Seattle" },
    { firstName: "Carlos", lastName: "Nguyen", city: "San Francisco" },
    { firstName: "Priya", lastName: "Patel",   city: "Austin" },
  ];

  const sdk = PeopleClient.fromEnv();

  console.log("
=== CONTACT ENRICHMENT ===
");

  for (const contact of contacts) {
    console.log(`${contact.firstName} ${contact.lastName}, ${contact.city}`);

    const record = await lookupContact(
      sdk,
      contact.firstName,
      contact.lastName,
      contact.city
    );

    if (record === null) {
      console.log("  No people record found.
");
      continue;
    }

    console.log(`  Name:    ${record.name ?? "N/A"}`);
    console.log(`  City:    ${record.city ?? "N/A"}`);
    console.log(`  Phones:  ${formatList(record.phones)}`);
    console.log(`  Emails:  ${formatList(record.emails)}`);
    console.log();
  }
}

main();

import { PeopleClient, DatafinitiApiError } from "datafiniti-sdk";

const sdk = PeopleClient.fromEnv();

try {
  const response = await sdk.search({ query: "country:US", numRecords: 5 });
  console.log(`Matches: ${response.num_found}`);
} catch (err) {
  if (err instanceof DatafinitiApiError) {
    console.error(`API error ${err.statusCode}: ${err.message}`, err.errors);
  } else {
    throw err;
  }
}