@memberjunction/actions-peopledatalabs 0.0.0 → 6.2.0-edge.4

package/LICENSE

@@ -0,0 +1,183 @@
+Business Source License 1.1
+
+License text copyright (c) 2024 MariaDB plc, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB plc.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Blue Cypress, Inc.
+
+Licensed Work:        MemberJunction.
+                      The Licensed Work is (c) 2023-2026 Blue Cypress, Inc.
+
+Additional Use Grant: Subject to the terms of this License, Licensor grants
+                      you the following additional rights to make Production
+                      Use of the Licensed Work.
+
+                      1. Internal Use
+
+                      You may make production use of the Licensed Work for
+                      your own internal business or organizational operations.
+
+                      2. Nonprofit Use
+
+                      If you are a Nonprofit, you may make production use of
+                      the Licensed Work for the operations and activities of
+                      your Organizational Family.
+
+                      3. MemberJunction Certified Program Use
+
+                      If you are authorized by Licensor under the
+                      MemberJunction Certified Program to provide professional
+                      services using the Licensed Work, you may make
+                      production use of the Licensed Work in providing such
+                      professional services to a client, provided that:
+
+                      (a) the Licensed Work is deployed in, and the applicable
+                      production use occurs within, an environment owned,
+                      leased, licensed, subscribed to, or otherwise controlled
+                      by that client; and
+
+                      (b) the production use is for that client's own internal
+                      business or organizational operations or is otherwise
+                      independently permitted to that client under this
+                      Additional Use Grant.
+
+                      4. Definitions Applicable to the Additional Use Grant
+
+                      "Affiliate" means, with respect to a specified Person,
+                      any other Person that directly or indirectly Controls,
+                      is Controlled by, or is under common Control with such
+                      specified Person.
+
+                      "Control" (including the terms "Controls," "Controlled
+                      by," and "under common Control with") means the direct
+                      or indirect possession of the power to direct or cause
+                      the direction of the management and policies of a
+                      Person, whether through ownership of voting interests,
+                      by contract, or otherwise.
+
+                      "Organizational Family" means, with respect to a Person,
+                      (a) such Person and its Affiliates, and (b) any
+                      nonprofit organization, governmental entity, chapter,
+                      division, local affiliate, regional affiliate, state
+                      affiliate, national affiliate, or other entity that is
+                      formally affiliated with such Person through governing
+                      documents, a charter, bylaws, a membership agreement, or
+                      another written organizational instrument, and is
+                      recognized under such documents as part of the same
+                      organizational structure.
+
+                      "Nonprofit" means a Person recognized by the Internal
+                      Revenue Service as exempt from federal income taxation
+                      under Section 501(c)(3), 501(c)(4), 501(c)(5), or
+                      501(c)(6) of the Internal Revenue Code, or a foreign
+                      organization recognized under substantially equivalent
+                      laws.
+
+                      A Person claiming eligibility as a Nonprofit shall, upon
+                      Licensor's reasonable request, provide documentation
+                      reasonably sufficient to demonstrate that it qualifies
+                      as a Nonprofit. If such Person materially misrepresents,
+                      or is unable to demonstrate, its qualification as a
+                      Nonprofit, the rights granted to such Person under
+                      Section 2 of this Additional Use Grant shall terminate.
+
+                      "MemberJunction Certified Program" means Licensor's
+                      then-current program for certifying and authorizing a
+                      Person to provide professional services using the
+                      Licensed Work.
+
+                      "Person" means any individual, corporation, limited
+                      liability company, partnership, association, nonprofit
+                      organization, governmental entity, or other legal or
+                      organizational entity.
+
+Change Date:          Four (4) years from the date the Licensed Work is first
+                      made available.
+
+Change License:       MIT License.
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact Blue Cypress, Inc.
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License
+   can be included in a program with software provided under GPL Version 2.0
+   or a later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/README.md

@@ -1,45 +1,92 @@
 # @memberjunction/actions-peopledatalabs
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/actions-peopledatalabs`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+A table-agnostic [People Data Labs](https://www.peopledatalabs.com/) client plus one thin Action.
+The client fetches and returns normalized person data; it never writes to the database, and it never
+returns emails, phone numbers or addresses. The Action exists for agents and workflows. Code that
+needs PDL data calls the client directly, never the Action.
+
+## What it covers
+
+| Surface | PDL endpoint | Billing (confirmed 2026-10-12) |
+|---|---|---|
+| `PDLPersonClient.BulkEnrich` | `POST /v5/person/bulk` | 1 credit per matched person; misses are free |
+| `PDLPersonClient.SearchPeople` | `POST /v5/person/search` | 1 credit per record returned |
+| `PDLPersonClient.CountPeople` | `POST /v5/person/search` with `size: 1` | 1 credit when anything matches |
+| `PDLPersonClient.SuggestSchools` | `GET /v5/autocomplete?field=school` | free, rate-limited |
+| `PDLPersonClient.CleanSchool` | `GET /v5/school/clean` | free, rate-limited |
+
+## Credentials
+
+Two paths, in order:
+
+1. A `CompanyID` resolves that company's active `People Data Labs` row in `MJ: Company Integrations`,
+   then its `CredentialID` in `MJ: Credentials`, whose `Values` hold `{ "apiKey": "…" }`.
+2. The `PDL_API_KEY` environment variable.
+
+`CompanyIntegration.APIKey` is never read: it is not decrypt-on-read, so a synced value comes back as
+ciphertext and PDL answers 401. A credential that exists but is malformed throws rather than falling
+back to the environment.
+
+The `MJ: Integrations` row named `People Data Labs` ships in `metadata/integrations/`.
+
+## Usage
+
+```typescript
+import { PDLPersonClient } from '@memberjunction/actions-peopledatalabs';
+
+const resolved = await PDLPersonClient.ForCompany(companyID, contextUser);
+if (!resolved) throw new Error('no PDL key');
+const result = await resolved.Client.BulkEnrich([
+    { Key: personID, Email: 'someone@example.org' },
+    { Key: otherID, FirstName: 'Ada', LastName: 'Lovelace', Company: 'analytical.example' },
+], { MinLikelihood: 6 });
+for (const match of result.Matches) {
+    // match.Matched, match.PDLID, match.Likelihood (1..10), match.LinkedInURL,
+    // match.Education[] { SchoolName, SchoolID, Degrees, Majors, StartDate, EndDate }
+    // match.Experience[] { CompanyName, CompanyDomain, Title, StartDate, EndDate, IsCurrent }
+}
+```
+
+Rules the client enforces:
+
+- At most 100 inputs per call, and every input needs an identifying field: `PDLID`, `Email`,
+  `LinkedInURL`, or first name plus last name plus company. Both checks run before any HTTP call.
+- `min_likelihood` is sent inside each request's `params`. At the request level PDL silently ignores
+  it and returns low-likelihood guesses.
+- Results are correlated by position and checked against the echoed `metadata.key`. A mismatch
+  throws rather than attaching one person's history to another.
+- Per item: 200 is a match, 404 a miss (free, not an error), anything else sets `ErrorMessage` on
+  that item only.
+- Top level: 401 and 403 become `PDLAuthError`, 402 `PDLCreditsExhaustedError`, 429
+  `PDLRateLimitError` with `RetryAfterSeconds` from `x-ratelimit-reset`, anything else
+  `PDLRequestError`. The client never sleeps.
+- Dates arrive as `YYYY`, `YYYY-MM` or `YYYY-MM-DD` and are normalized to the first day of the year
+  or month.
+- `Required` and `DataInclude` are passed through when set, but PDL did not apply them on the plan
+  this was built against. The field mapping here is the real minimization.
+
+A note on schools: PDL may file a degree under the parent university. A Harvard Kennedy School
+master's came back as `school.name = "harvard university"` with major `public administration`.
+`CleanSchool` is not reliable alone (it mapped "John F. Kennedy School of Government" to
+`john f. kennedy school`); clean, then confirm with `SuggestSchools`, which returns ids and counts.
+
+## The Action
+
+`People Data Labs - Enrich People` (`DriverClass` `PDLEnrichPeopleAction`), category Data Enrichment.
+
+| Param | Type | Notes |
+|---|---|---|
+| People | Input, required | JSON array (or JSON string) of `{ Email, LinkedInURL, FirstName, LastName, Company, PDLID, Key }`, at most 100 |
+| MinLikelihood | Input | 1 to 10, default 6 |
+| CompanyID | Input | Per-company credential, as above |
+| Matches | Output | The normalized `PDLPersonMatch[]`, in input order |
+| MatchedCount, CreditsConsumed, KeySource | Output | |
+
+Result codes: `SUCCESS`, `NO_MATCHES` (a success), `RATE_LIMITED`, `CREDITS_EXHAUSTED`,
+`CREDENTIALS_NOT_FOUND`, `CONFIGURATION_ERROR`, `VALIDATION_ERROR`, `ERROR`.
+
+## Tests
+
+`pnpm test`. Every test uses an injected fetch and the redacted fixtures under
+`src/__tests__/fixtures/`, captured from live responses on 2026-10-12. Nothing reaches PDL from a
+test.

package/dist/PDLEnrichPeopleAction.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `People Data Labs - Enrich People`: a thin Action for agents and workflows. It resolves a key,
+ * calls `PDLPersonClient.BulkEnrich` for up to 100 people, and returns the normalized matches. It
+ * writes nothing to the database; code that needs PDL data calls the client directly, never this
+ * Action (MJ/packages/Actions/CLAUDE.md: code-to-code calls never go through Actions).
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { PDLPersonClient } from './PDLPersonClient.js';
+export type PDLEnrichPeopleResultCode = 'SUCCESS' | 'NO_MATCHES' | 'RATE_LIMITED' | 'CREDITS_EXHAUSTED' | 'CREDENTIALS_NOT_FOUND' | 'CONFIGURATION_ERROR' | 'VALIDATION_ERROR' | 'ERROR';
+export declare class PDLEnrichPeopleAction extends BaseAction {
+    /** Seam for tests: swap the client without touching the network. */
+    protected CreateClient(apiKey: string): PDLPersonClient;
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private resolveClient;
+    private enrich;
+    private failure;
+}
+export declare function LoadPDLEnrichPeopleAction(): void;
+//# sourceMappingURL=PDLEnrichPeopleAction.d.ts.map

package/dist/PDLEnrichPeopleAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PDLEnrichPeopleAction.d.ts","sourceRoot":"","sources":["../src/PDLEnrichPeopleAction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMxF,OAAO,EAA4B,eAAe,EAA0C,MAAM,sBAAsB,CAAC;AAEzH,MAAM,MAAM,yBAAyB,GAC/B,SAAS,GACT,YAAY,GACZ,cAAc,GACd,mBAAmB,GACnB,uBAAuB,GACvB,qBAAqB,GACrB,kBAAkB,GAClB,OAAO,CAAC;AAId,qBACa,qBAAsB,SAAQ,UAAU;IACjD,oEAAoE;IACpE,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;cAIvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAazE,aAAa;YAYb,MAAM;IAiBpB,OAAO,CAAC,OAAO;CASlB;AAkBD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/PDLEnrichPeopleAction.js

@@ -0,0 +1,104 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * `People Data Labs - Enrich People`: a thin Action for agents and workflows. It resolves a key,
+ * calls `PDLPersonClient.BulkEnrich` for up to 100 people, and returns the normalized matches. It
+ * writes nothing to the database; code that needs PDL data calls the client directly, never this
+ * Action (MJ/packages/Actions/CLAUDE.md: code-to-code calls never go through Actions).
+ */
+import { BaseAction } from '@memberjunction/actions';
+import { LogError } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { DefaultMinLikelihood } from './config.js';
+import { NO_PDL_KEY_MESSAGE, ResolvePDLAPIKey } from './credentials.js';
+import { GetParam, GetParamRaw, ParseObjectArrayParam, ParseOptionalIntegerParam } from './params.js';
+import { PDLCreditsExhaustedError, PDLPersonClient, PDLRateLimitError } from './PDLPersonClient.js';
+const PERSON_FIELDS = ['Key', 'PDLID', 'Email', 'LinkedInURL', 'FirstName', 'LastName', 'Company'];
+let PDLEnrichPeopleAction = class PDLEnrichPeopleAction extends BaseAction {
+    /** Seam for tests: swap the client without touching the network. */
+    CreateClient(apiKey) {
+        return new PDLPersonClient(apiKey);
+    }
+    async InternalRunAction(params) {
+        const people = ParseObjectArrayParam(GetParamRaw(params, 'People'), 'People');
+        if (people.error)
+            return Fail('VALIDATION_ERROR', people.error);
+        if (!people.value || people.value.length === 0)
+            return Fail('VALIDATION_ERROR', 'People is required: a JSON array of { Email, LinkedInURL, FirstName, LastName, Company }.');
+        if (people.value.length > PDLPersonClient.MaxBatchSize)
+            return Fail('VALIDATION_ERROR', `People holds ${people.value.length} entries; at most ${PDLPersonClient.MaxBatchSize} per call.`);
+        const likelihood = ParseOptionalIntegerParam(GetParamRaw(params, 'MinLikelihood'), 'MinLikelihood', { min: 1, max: 10 });
+        if (likelihood.error)
+            return Fail('VALIDATION_ERROR', likelihood.error);
+        const inputs = people.value.map(ToInput);
+        const resolved = await this.resolveClient(params);
+        if ('error' in resolved)
+            return resolved.error;
+        return this.enrich(params, resolved.client, resolved.key, inputs, likelihood.value ?? DefaultMinLikelihood);
+    }
+    async resolveClient(params) {
+        let key;
+        try {
+            key = await ResolvePDLAPIKey(GetParam(params, 'CompanyID'), params.ContextUser);
+        }
+        catch (error) {
+            // A credential that exists but is malformed: say so, never fall back to another company's key.
+            return { error: Fail('CONFIGURATION_ERROR', error instanceof Error ? error.message : String(error)) };
+        }
+        if (!key)
+            return { error: Fail('CREDENTIALS_NOT_FOUND', NO_PDL_KEY_MESSAGE) };
+        return { client: this.CreateClient(key.apiKey), key };
+    }
+    async enrich(params, client, key, inputs, minLikelihood) {
+        try {
+            const result = await client.BulkEnrich(inputs, { MinLikelihood: minLikelihood });
+            const matched = result.Matches.filter((match) => match.Matched).length;
+            params.Params.push({ Name: 'Matches', Type: 'Output', Value: result.Matches }, { Name: 'MatchedCount', Type: 'Output', Value: matched }, { Name: 'CreditsConsumed', Type: 'Output', Value: result.CreditsConsumed }, { Name: 'KeySource', Type: 'Output', Value: key.source });
+            const code = matched > 0 ? 'SUCCESS' : 'NO_MATCHES';
+            return { Success: true, ResultCode: code, Message: `People Data Labs: ${matched} of ${inputs.length} matched, ${result.CreditsConsumed} credits.`, Params: params.Params };
+        }
+        catch (error) {
+            return this.failure(error);
+        }
+    }
+    failure(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        LogError(`PDLEnrichPeople: ${message}`);
+        if (error instanceof PDLRateLimitError)
+            return Fail('RATE_LIMITED', message);
+        if (error instanceof PDLCreditsExhaustedError)
+            return Fail('CREDITS_EXHAUSTED', message);
+        if (error instanceof Error && error.name === 'PDLAuthError')
+            return Fail('CREDENTIALS_NOT_FOUND', message);
+        if (error instanceof Error && !error.name.startsWith('PDL'))
+            return Fail('VALIDATION_ERROR', message);
+        return Fail('ERROR', `Error enriching people through People Data Labs: ${message}`);
+    }
+};
+PDLEnrichPeopleAction = __decorate([
+    RegisterClass(BaseAction, 'PDLEnrichPeopleAction')
+], PDLEnrichPeopleAction);
+export { PDLEnrichPeopleAction };
+function Fail(code, message) {
+    return { Success: false, ResultCode: code, Message: message };
+}
+/** Accepts the documented field names in any casing; the Key defaults to the row's position. */
+function ToInput(row, index) {
+    const input = { Key: String(index) };
+    for (const field of PERSON_FIELDS) {
+        const entry = Object.entries(row).find(([name]) => name.toLowerCase() === field.toLowerCase());
+        const value = entry?.[1];
+        if (value === undefined || value === null || String(value).trim() === '')
+            continue;
+        input[field] = String(value).trim();
+    }
+    return input;
+}
+export function LoadPDLEnrichPeopleAction() {
+    // Referenced by consumers to keep the registration from being tree-shaken.
+}
+//# sourceMappingURL=PDLEnrichPeopleAction.js.map

package/dist/PDLEnrichPeopleAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PDLEnrichPeopleAction.js","sourceRoot":"","sources":["../src/PDLEnrichPeopleAction.ts"],"names":[],"mappings":"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"}

package/dist/PDLPersonClient.d.ts

@@ -0,0 +1,164 @@
+/**
+ * A table-agnostic People Data Labs client: bulk person enrichment, person search, a size-1 count,
+ * and the free school lookups. It fetches and returns normalized data and writes nothing. Only the
+ * fields below are mapped; emails, phones, addresses and everything else PDL returns never leave
+ * this module unless `IncludeRaw` is set for debugging.
+ */
+import { type UserInfo } from '@memberjunction/core';
+export interface PDLPersonInput {
+    /** Correlation key; common passes the Person ID. Echoed back by PDL as `metadata.key`. */
+    Key: string;
+    /** Exact re-match when known; sent as `pdl_id`. */
+    PDLID?: string;
+    Email?: string;
+    /** Sent as PDL's `profile` param. */
+    LinkedInURL?: string;
+    FirstName?: string;
+    LastName?: string;
+    /** Employer name or domain. */
+    Company?: string;
+}
+export interface PDLEducationEntry {
+    SchoolName: string;
+    SchoolID: string | null;
+    Degrees: string[];
+    Majors: string[];
+    /** Normalized 'YYYY-MM-DD'. */
+    StartDate: string | null;
+    EndDate: string | null;
+}
+export interface PDLExperienceEntry {
+    CompanyName: string;
+    /** Host of `company.website`, normalized. */
+    CompanyDomain: string | null;
+    Title: string | null;
+    StartDate: string | null;
+    EndDate: string | null;
+    IsCurrent: boolean;
+}
+export interface PDLPersonMatch {
+    Key: string;
+    Matched: boolean;
+    PDLID: string | null;
+    /** 1..10 */
+    Likelihood: number | null;
+    LinkedInURL: string | null;
+    Education: PDLEducationEntry[];
+    Experience: PDLExperienceEntry[];
+    /** Set when this one item failed (non-200, non-404). */
+    ErrorMessage: string | null;
+    /** Only with IncludeRaw; never persist. */
+    Raw?: Record<string, unknown>;
+}
+export interface PDLBulkOptions {
+    /** Default 6, PDL's recommended value. Sent inside each request's `params`; at the request level PDL ignores it. */
+    MinLikelihood?: number;
+    /** e.g. 'education'. Accepted but not applied on every plan; never rely on it. */
+    Required?: string;
+    /** Not applied on every plan; the mapping above is the real minimization. */
+    DataInclude?: string[];
+    IncludeRaw?: boolean;
+}
+export interface PDLBulkResult {
+    /** Same length and order as the input. */
+    Matches: PDLPersonMatch[];
+    /** From `x-call-credits-spent` when PDL sends it, else the count of per-item 200s. */
+    CreditsConsumed: number;
+}
+/** A typed subset of PDL's Elasticsearch query. Built from clauses, so no value is ever spliced into query text. */
+export type PDLQueryClause = {
+    term: Record<string, string>;
+} | {
+    terms: Record<string, string[]>;
+} | {
+    match: Record<string, string>;
+} | {
+    range: Record<string, {
+        gte?: string;
+        lte?: string;
+    }>;
+} | PDLBoolQuery;
+export interface PDLBoolQuery {
+    bool: {
+        must?: PDLQueryClause[];
+        should?: PDLQueryClause[];
+        minimum_should_match?: number;
+    };
+}
+export interface PDLPersonSearchRequest {
+    Query: PDLBoolQuery;
+    /** 1..100 */
+    Size: number;
+    /** From the previous page. */
+    ScrollToken?: string;
+}
+export interface PDLPersonSearchPage {
+    /** PDL's total for the query. */
+    Total: number;
+    /** Normalized like BulkEnrich; Key = PDL person id, Matched = true. */
+    People: PDLPersonMatch[];
+    /** Null on the last page. */
+    ScrollToken: string | null;
+    /** Records returned, which is what PDL bills for a search. */
+    CreditsConsumed: number;
+}
+export interface PDLSchoolSuggestion {
+    Name: string;
+    SchoolID: string | null;
+    /** Autocomplete's per-suggestion count; null from the cleaner. */
+    Count: number | null;
+}
+export interface PDLPersonClientOptions {
+    /** Injected fetch, for tests. Tests must never reach api.peopledatalabs.com. */
+    FetchImpl?: typeof fetch;
+    BaseURL?: string;
+}
+export declare class PDLRateLimitError extends Error {
+    readonly RetryAfterSeconds: number | null;
+    constructor(message: string, retryAfterSeconds: number | null);
+}
+export declare class PDLCreditsExhaustedError extends Error {
+    constructor(message: string);
+}
+export declare class PDLAuthError extends Error {
+    readonly Status: number;
+    constructor(message: string, status: number);
+}
+export declare class PDLRequestError extends Error {
+    readonly Status: number;
+    readonly Body: string;
+    constructor(message: string, status: number, body: string);
+}
+export declare class PDLPersonClient {
+    static readonly MaxBatchSize = 100;
+    static readonly MaxSearchPageSize = 100;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    private readonly baseURL;
+    constructor(apiKey: string, options?: PDLPersonClientOptions);
+    /** Resolve the key through the credentials path (company credential, then PDL_API_KEY), then construct a client. */
+    static ForCompany(companyID: string | null, contextUser: UserInfo | undefined, options?: PDLPersonClientOptions): Promise<{
+        Client: PDLPersonClient;
+        KeySource: 'credential' | 'environment';
+    } | null>;
+    BulkEnrich(inputs: PDLPersonInput[], options?: PDLBulkOptions): Promise<PDLBulkResult>;
+    /** One page of Person Search. Billed per record returned. A no-records response is `Total: 0`, not an error. */
+    SearchPeople(request: PDLPersonSearchRequest): Promise<PDLPersonSearchPage>;
+    /** A size-1 search that returns only the total; the one record is discarded unmapped. */
+    CountPeople(query: PDLBoolQuery): Promise<{
+        Total: number;
+        CreditsConsumed: number;
+    }>;
+    /** Autocomplete on `field=school`. Free of credits; rate-limited only. */
+    SuggestSchools(text: string, size?: number): Promise<PDLSchoolSuggestion[]>;
+    /** School Cleaner. Free of credits. Returns null when PDL can't resolve the name. Not trustworthy alone: confirm with SuggestSchools. */
+    CleanSchool(name: string): Promise<PDLSchoolSuggestion | null>;
+    private request;
+}
+/** `YYYY`, `YYYY-MM` and `YYYY-MM-DD` to the first day of the year or month; anything else to null. */
+/** Strips trailing slashes without a regex: `/\/+$/` is quadratic on a long run of slashes (CodeQL js/polynomial-redos). */
+export declare function TrimTrailingSlashes(value: string): string;
+export declare function NormalizeDate(value: string | null | undefined): string | null;
+/** Bare host of a website or domain value. */
+export declare function DomainOf(value: string | null | undefined): string | null;
+//# sourceMappingURL=PDLPersonClient.d.ts.map

package/dist/PDLPersonClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PDLPersonClient.d.ts","sourceRoot":"","sources":["../src/PDLPersonClient.ts"],"names":[],"mappings":"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"}