@memberjunction/actions-apollo 6.1.0-edge.4 → 6.1.0-edge.6

package/dist/lists/ApolloSearchActions.js

@@ -0,0 +1,239 @@
+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;
+};
+/**
+ * Apollo search actions: page through a list's members, and search Apollo's
+ * people database for net-new prospects.
+ *
+ * The two list-member searches return each record's CURRENT label names, which is
+ * what makes a later move able to preserve the record's other memberships. That is
+ * the reason these are separate from a move action rather than folded into it:
+ * read, decide, then move, with the labels you actually read.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { BaseAction } from '@memberjunction/actions';
+import { ApolloRESTBaseAction } from './ApolloRESTBaseAction.js';
+import { LIST_NOT_FOUND_HINT, getParam, getParamRaw, parseOptionalIntegerParam, parseStringArrayParam } from './params.js';
+/** Shared paging parse for the three search actions. Apollo's caps are 500 pages of 100. */
+function parsePaging(params) {
+    const pageParsed = parseOptionalIntegerParam(getParamRaw(params, 'Page'), 'Page', { min: 1, max: 500 });
+    if (pageParsed.error !== null)
+        return { paging: {}, error: pageParsed.error };
+    const perPageParsed = parseOptionalIntegerParam(getParamRaw(params, 'PerPage'), 'PerPage', { min: 1, max: 100 });
+    if (perPageParsed.error !== null)
+        return { paging: {}, error: perPageParsed.error };
+    const paging = {};
+    if (pageParsed.value !== undefined)
+        paging.page = pageParsed.value;
+    if (perPageParsed.value !== undefined)
+        paging.perPage = perPageParsed.value;
+    return { paging, error: null };
+}
+/**
+ * Pages through the accounts in an Apollo list, addressed by exact list name.
+ *
+ * Returns each account's id, name, primary domain and current label names.
+ *
+ * When draining a list — reading members in order to move them out — read page 1
+ * every time. Removals shift every later page, so advancing to page 2 skips
+ * records. Read-only.
+ *
+ * Inputs:
+ *   - ListName  (required) exact label name; run Apollo Get Lists to see them
+ *   - Keywords  (optional) organization-name filter within the list
+ *   - Page      (optional, default 1, max 500)
+ *   - PerPage   (optional, default 100, max 100)
+ *   - CompanyID (optional) per-company credential resolution
+ *
+ * Outputs:
+ *   - Accounts / Pagination / Count / ResolvedListName / ListID / KeySource
+ */
+let ApolloGetListAccountsAction = class ApolloGetListAccountsAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const listName = getParam(params, 'ListName');
+        if (!listName)
+            return this.MissingField('ListName');
+        const keywords = getParam(params, 'Keywords');
+        const { paging, error: pagingError } = parsePaging(params);
+        if (pagingError !== null)
+            return this.Invalid(pagingError);
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const label = await resolved.client.findLabelByName(listName);
+            if (!label) {
+                return {
+                    Success: false,
+                    Message: `No Apollo list named '${listName}' was found. ${LIST_NOT_FOUND_HINT}`,
+                    ResultCode: 'NOT_FOUND',
+                };
+            }
+            const filter = { labelIds: [label.id] };
+            if (keywords)
+                filter.keywords = keywords;
+            const result = await resolved.client.searchAccounts(filter, paging);
+            params.Params.push({ Name: 'Accounts', Type: 'Output', Value: result.accounts }, { Name: 'Pagination', Type: 'Output', Value: result.pagination }, { Name: 'Count', Type: 'Output', Value: result.accounts.length }, { Name: 'ResolvedListName', Type: 'Output', Value: label.name }, { Name: 'ListID', Type: 'Output', Value: label.id }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                Success: true,
+                Message: `Apollo accounts in '${label.name}': ${result.accounts.length} on page ${result.pagination.page} ` +
+                    `of ${result.pagination.totalPages} (${result.pagination.totalEntries} total).`,
+                ResultCode: 'SUCCESS',
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloGetListAccounts: ${msg}`);
+            return { Success: false, Message: `Error fetching Apollo accounts: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloGetListAccountsAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloGetListAccountsAction')
+], ApolloGetListAccountsAction);
+export { ApolloGetListAccountsAction };
+/**
+ * Pages through the contacts in an Apollo list. Same shape and same drain
+ * discipline as {@link ApolloGetListAccountsAction}; `Keywords` here matches
+ * names, titles, employers and emails rather than organization names.
+ *
+ * Outputs: Contacts / Pagination / Count / ResolvedListName / ListID / KeySource
+ */
+let ApolloGetListContactsAction = class ApolloGetListContactsAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const listName = getParam(params, 'ListName');
+        if (!listName)
+            return this.MissingField('ListName');
+        const keywords = getParam(params, 'Keywords');
+        const { paging, error: pagingError } = parsePaging(params);
+        if (pagingError !== null)
+            return this.Invalid(pagingError);
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const label = await resolved.client.findLabelByName(listName);
+            if (!label) {
+                return {
+                    Success: false,
+                    Message: `No Apollo list named '${listName}' was found. ${LIST_NOT_FOUND_HINT}`,
+                    ResultCode: 'NOT_FOUND',
+                };
+            }
+            const filter = { labelIds: [label.id] };
+            if (keywords)
+                filter.keywords = keywords;
+            const result = await resolved.client.searchContacts(filter, paging);
+            params.Params.push({ Name: 'Contacts', Type: 'Output', Value: result.contacts }, { Name: 'Pagination', Type: 'Output', Value: result.pagination }, { Name: 'Count', Type: 'Output', Value: result.contacts.length }, { Name: 'ResolvedListName', Type: 'Output', Value: label.name }, { Name: 'ListID', Type: 'Output', Value: label.id }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                Success: true,
+                Message: `Apollo contacts in '${label.name}': ${result.contacts.length} on page ${result.pagination.page} ` +
+                    `of ${result.pagination.totalPages} (${result.pagination.totalEntries} total).`,
+                ResultCode: 'SUCCESS',
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloGetListContacts: ${msg}`);
+            return { Success: false, Message: `Error fetching Apollo contacts: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloGetListContactsAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloGetListContactsAction')
+], ApolloGetListContactsAction);
+export { ApolloGetListContactsAction };
+/**
+ * Searches Apollo's people database for net-new prospects by organization, title
+ * and seniority — the list-building workhorse.
+ *
+ * This endpoint does not return emails or phones. That is Apollo's design, not an
+ * omission here: contact details come from the enrichment actions in this package,
+ * which are metered separately.
+ *
+ * At least one filter is required. Apollo will accept a request with none and
+ * return an unscoped result set, which burns the rate limit to produce something
+ * nobody asked for, so that case is rejected before the call.
+ *
+ * Inputs:
+ *   - OrganizationDomains (optional) company domains
+ *   - OrganizationIDs     (optional) Apollo organization ids
+ *   - Titles              (optional) job titles, e.g. ["VP of Marketing"]
+ *   - Seniorities         (optional) owner | founder | c_suite | vp | director | manager
+ *   - Page / PerPage      (optional)
+ *   - CompanyID           (optional)
+ *
+ * Each list param accepts a real array, a JSON array string, or a
+ * comma-separated string.
+ *
+ * Outputs: People / Pagination / Count / KeySource
+ */
+let ApolloSearchPeopleAction = class ApolloSearchPeopleAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const domainsParsed = parseStringArrayParam(getParamRaw(params, 'OrganizationDomains'), 'OrganizationDomains');
+        if (domainsParsed.error !== null)
+            return this.Invalid(domainsParsed.error);
+        const orgIdsParsed = parseStringArrayParam(getParamRaw(params, 'OrganizationIDs'), 'OrganizationIDs');
+        if (orgIdsParsed.error !== null)
+            return this.Invalid(orgIdsParsed.error);
+        const titlesParsed = parseStringArrayParam(getParamRaw(params, 'Titles'), 'Titles');
+        if (titlesParsed.error !== null)
+            return this.Invalid(titlesParsed.error);
+        const senioritiesParsed = parseStringArrayParam(getParamRaw(params, 'Seniorities'), 'Seniorities');
+        if (senioritiesParsed.error !== null)
+            return this.Invalid(senioritiesParsed.error);
+        const { paging, error: pagingError } = parsePaging(params);
+        if (pagingError !== null)
+            return this.Invalid(pagingError);
+        if (domainsParsed.value === undefined &&
+            orgIdsParsed.value === undefined &&
+            titlesParsed.value === undefined &&
+            senioritiesParsed.value === undefined) {
+            return this.Invalid('Provide at least one of OrganizationDomains, OrganizationIDs, Titles, or Seniorities — ' +
+                'an unscoped people search returns a rate-limited firehose.');
+        }
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const filter = {};
+            if (domainsParsed.value)
+                filter.organizationDomains = domainsParsed.value;
+            if (orgIdsParsed.value)
+                filter.organizationIds = orgIdsParsed.value;
+            if (titlesParsed.value)
+                filter.titles = titlesParsed.value;
+            if (senioritiesParsed.value)
+                filter.seniorities = senioritiesParsed.value;
+            const result = await resolved.client.searchPeople(filter, paging);
+            params.Params.push({ Name: 'People', Type: 'Output', Value: result.people }, { Name: 'Pagination', Type: 'Output', Value: result.pagination }, { Name: 'Count', Type: 'Output', Value: result.people.length }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                Success: true,
+                Message: `Apollo people search: ${result.people.length} on page ${result.pagination.page} ` +
+                    `of ${result.pagination.totalPages} (${result.pagination.totalEntries} total). ` +
+                    `Emails and phones are not returned by this endpoint.`,
+                ResultCode: 'SUCCESS',
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloSearchPeople: ${msg}`);
+            return { Success: false, Message: `Error searching Apollo people: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloSearchPeopleAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloSearchPeopleAction')
+], ApolloSearchPeopleAction);
+export { ApolloSearchPeopleAction };
+export function LoadApolloSearchActions() {
+    // Referenced by consumers to keep these registrations from being tree-shaken.
+}
+//# sourceMappingURL=ApolloSearchActions.js.map

package/dist/lists/ApolloSearchActions.js.map

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

package/dist/lists/credentials.d.ts

@@ -0,0 +1,57 @@
+/**
+ * API-key resolution for the Apollo list and search actions.
+ *
+ * Two paths, in this order:
+ *
+ *   1. A `CompanyID` param → that company's active Apollo `MJ: Company Integrations`
+ *      row → its `CredentialID` → the `apiKey` inside `MJ: Credentials.Values`.
+ *      This is the multi-tenant path: several companies in one instance, each with
+ *      its own Apollo workspace and its own key.
+ *   2. `APOLLO_API_KEY` from the environment, which is what the enrichment actions
+ *      in this package have always used. Single-tenant deployments keep working
+ *      without any credential rows.
+ *
+ * `CompanyIntegration.APIKey` is deliberately NOT read, even though it exists and
+ * looks like the obvious place. That column is not a decrypt-on-read field, so a
+ * key written through metadata sync comes back as the literal ciphertext string
+ * `$ENC$…`. Sending that to Apollo produces a 401 whose message says nothing about
+ * encryption, and the failure looks exactly like a wrong key. `MJ: Credentials` is
+ * the field that decrypts, so it is the only one used.
+ *
+ * Every write in this surface needs a MASTER Apollo key. That is not something
+ * this code can detect ahead of time — a scoped key authenticates fine and then
+ * 403s on the first PATCH — so the client turns that 403 into an explanation, and
+ * the message below names the requirement up front.
+ */
+import { type UserInfo } from '@memberjunction/core';
+/** The integration name looked up on the CompanyIntegration row. */
+export declare const APOLLO_INTEGRATION_NAME = "Apollo";
+/** The standard failure text when neither resolution path yields a key. */
+export declare const NO_APOLLO_KEY_MESSAGE: string;
+/** Where a resolved key came from, so an action can say so in its output. */
+export interface ResolvedApolloKey {
+    apiKey: string;
+    source: 'credential' | 'environment';
+    /** The CompanyIntegration row's id when resolved through a company; null otherwise. */
+    companyIntegrationID: string | null;
+}
+/**
+ * Pull the Apollo key out of a credential's `Values` JSON.
+ *
+ * Several key names are accepted because credential records get authored by hand
+ * and the casing varies. A `Values` blob that will not parse throws rather than
+ * falling through to the environment — a present-but-broken credential is a
+ * configuration error worth surfacing, not a reason to silently use a different
+ * workspace's key.
+ */
+export declare function extractApolloKey(values: string | null | undefined, credentialName: string): string | null;
+/**
+ * Resolve the key for this run. `companyID` is optional: without it, only the
+ * environment is consulted.
+ *
+ * Returns null rather than throwing when nothing is configured, so an action can
+ * answer with `CREDENTIALS_NOT_FOUND` instead of a stack trace. A credential that
+ * exists but is malformed does throw — see {@link extractApolloKey}.
+ */
+export declare function resolveApolloAPIKey(companyID: string | null, contextUser: UserInfo | undefined): Promise<ResolvedApolloKey | null>;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/lists/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lists/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKlF,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,QAIoD,CAAC;AAEvF,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC;IACrC,uFAAuF;IACvF,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBzG;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,QAAQ,GAAG,SAAS,GAClC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAUnC"}

package/dist/lists/credentials.js

@@ -0,0 +1,161 @@
+/**
+ * API-key resolution for the Apollo list and search actions.
+ *
+ * Two paths, in this order:
+ *
+ *   1. A `CompanyID` param → that company's active Apollo `MJ: Company Integrations`
+ *      row → its `CredentialID` → the `apiKey` inside `MJ: Credentials.Values`.
+ *      This is the multi-tenant path: several companies in one instance, each with
+ *      its own Apollo workspace and its own key.
+ *   2. `APOLLO_API_KEY` from the environment, which is what the enrichment actions
+ *      in this package have always used. Single-tenant deployments keep working
+ *      without any credential rows.
+ *
+ * `CompanyIntegration.APIKey` is deliberately NOT read, even though it exists and
+ * looks like the obvious place. That column is not a decrypt-on-read field, so a
+ * key written through metadata sync comes back as the literal ciphertext string
+ * `$ENC$…`. Sending that to Apollo produces a 401 whose message says nothing about
+ * encryption, and the failure looks exactly like a wrong key. `MJ: Credentials` is
+ * the field that decrypts, so it is the only one used.
+ *
+ * Every write in this surface needs a MASTER Apollo key. That is not something
+ * this code can detect ahead of time — a scoped key authenticates fine and then
+ * 403s on the first PATCH — so the client turns that 403 into an explanation, and
+ * the message below names the requirement up front.
+ */
+import { LogError, RunView } from '@memberjunction/core';
+import { ApolloAPIKey } from '../config.js';
+import { CredentialEngine } from '@memberjunction/credentials';
+/** The integration name looked up on the CompanyIntegration row. */
+export const APOLLO_INTEGRATION_NAME = 'Apollo';
+/** The standard failure text when neither resolution path yields a key. */
+export const NO_APOLLO_KEY_MESSAGE = `No Apollo API key could be resolved. Either link an active '${APOLLO_INTEGRATION_NAME}' ` +
+    `MJ: Company Integrations row for the supplied CompanyID to an MJ: Credentials record whose Values ` +
+    `contain { "apiKey": "…" }, or set the APOLLO_API_KEY environment variable. ` +
+    `List reads and every write require a MASTER Apollo key — scoped keys return 403.`;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Pull the Apollo key out of a credential's `Values` JSON.
+ *
+ * Several key names are accepted because credential records get authored by hand
+ * and the casing varies. A `Values` blob that will not parse throws rather than
+ * falling through to the environment — a present-but-broken credential is a
+ * configuration error worth surfacing, not a reason to silently use a different
+ * workspace's key.
+ */
+export function extractApolloKey(values, credentialName) {
+    if (!values || values.trim().length === 0)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(values);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        throw new Error(`Apollo credential '${credentialName}' has a Values payload that is not valid JSON: ${msg}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new Error(`Apollo credential '${credentialName}' Values must be a JSON object containing an apiKey.`);
+    }
+    for (const key of ['apiKey', 'APIKey', 'api_key', 'ApiKey', 'masterApiKey']) {
+        const candidate = parsed[key];
+        if (typeof candidate === 'string' && candidate.trim().length > 0) {
+            return candidate.trim();
+        }
+    }
+    return null;
+}
+/**
+ * Resolve the key for this run. `companyID` is optional: without it, only the
+ * environment is consulted.
+ *
+ * Returns null rather than throwing when nothing is configured, so an action can
+ * answer with `CREDENTIALS_NOT_FOUND` instead of a stack trace. A credential that
+ * exists but is malformed does throw — see {@link extractApolloKey}.
+ */
+export async function resolveApolloAPIKey(companyID, contextUser) {
+    if (companyID) {
+        const fromCredential = await resolveFromCompany(companyID, contextUser);
+        if (fromCredential)
+            return fromCredential;
+    }
+    const env = ApolloAPIKey.trim();
+    if (env.length > 0) {
+        return { apiKey: env, source: 'environment', companyIntegrationID: null };
+    }
+    return null;
+}
+/** Canonical 8-4-4-4-12 hex form. `CompanyID` is a uniqueidentifier, so anything else is not one. */
+const UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+async function resolveFromCompany(companyID, contextUser) {
+    // VALIDATE rather than escape. This value is interpolated into an ExtraFilter, and while
+    // `ValidateUserProvidedSQLClause` blocks `;`, `--`, UNION and DML, it does NOT block boolean
+    // logic: `x' OR '1'='1` passes the screen, which is enough to select a DIFFERENT TENANT'S
+    // CompanyIntegration row and therefore resolve their Apollo key. A UUID check admits nothing
+    // that could alter the clause's shape, which escaping alone does not guarantee.
+    if (!UUID_PATTERN.test(companyID)) {
+        LogError(`resolveApolloAPIKey: CompanyID '${companyID}' is not a UUID; refusing to build a filter from it.`);
+        return null;
+    }
+    const rv = new RunView();
+    const result = await rv.RunView({
+        EntityName: 'MJ: Company Integrations',
+        // IsActive is nullable, so an unset flag must not exclude the row —
+        // a company with one Apollo integration and a NULL IsActive is the
+        // common shape after a hand-authored insert.
+        ExtraFilter: `CompanyID = '${companyID}' AND Integration = '${APOLLO_INTEGRATION_NAME}' AND (IsActive IS NULL OR IsActive = 1)`,
+        ResultType: 'simple',
+    }, contextUser);
+    if (!result.Success) {
+        LogError(`resolveApolloAPIKey: reading MJ: Company Integrations failed — ${result.ErrorMessage ?? 'unknown error'}`);
+        return null;
+    }
+    const row = result.Results?.[0];
+    if (!row)
+        return null;
+    if (!row.CredentialID) {
+        LogError(`resolveApolloAPIKey: CompanyIntegration ${row.ID} has no CredentialID. ` +
+            `The APIKey column is not read — it is not decrypt-on-read, so a synced value comes back as ciphertext. ` +
+            `Link an MJ: Credentials record instead.`);
+        return null;
+    }
+    // Through CredentialEngine rather than GetEntityObject + Load: that path reads the row but
+    // records nothing. The engine's `logAccess` writes an `MJ: Audit Logs` row and stamps
+    // LastUsedAt, validates Values against the credential type's schema, and serves from cache
+    // instead of a load per action invocation.
+    await CredentialEngine.Instance.Config(false, contextUser);
+    const credential = CredentialEngine.Instance.Credentials.find((c) => c.ID.toLowerCase() === row.CredentialID.toLowerCase());
+    if (!credential) {
+        LogError(`resolveApolloAPIKey: MJ: Credentials record ${row.CredentialID} could not be loaded.`);
+        return null;
+    }
+    // Kept explicitly: the engine filters IsActive on its by-NAME path only, and this resolves by
+    // ID. Relying on the engine here would silently accept an inactive credential.
+    if (credential.IsActive === false) {
+        LogError(`resolveApolloAPIKey: MJ: Credentials record '${credential.Name}' is inactive.`);
+        return null;
+    }
+    let values;
+    try {
+        const resolved = await CredentialEngine.Instance.getCredential(credential.Name, {
+            credentialId: row.CredentialID,
+            contextUser,
+            subsystem: 'Apollo',
+        });
+        values = resolved.values;
+    }
+    catch (err) {
+        LogError(`resolveApolloAPIKey: MJ: Credentials record '${credential.Name}' could not be resolved — ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    const apiKey = extractApolloKey(values ? JSON.stringify(values) : null, credential.Name);
+    if (!apiKey) {
+        LogError(`resolveApolloAPIKey: MJ: Credentials record '${credential.Name}' contains no apiKey value.`);
+        return null;
+    }
+    return { apiKey, source: 'credential', companyIntegrationID: row.ID };
+}
+//# sourceMappingURL=credentials.js.map

package/dist/lists/credentials.js.map

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

package/dist/lists/params.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Parameter parsing for the Apollo list and search actions.
+ *
+ * Pure functions over raw param values, with no framework imports, so every
+ * action validates its inputs identically and the validation is testable without
+ * constructing an action. They report problems as strings; the actions own the
+ * `Success`/`ResultCode` shape.
+ *
+ * The permissiveness is deliberate. These actions are called from three places
+ * that supply values in three different forms: an agent's input mapping passes a
+ * real array, an LLM writing params passes a JSON string, and a human testing in
+ * the UI types `owner, founder`. All three mean the same thing, so all three are
+ * accepted — while genuinely malformed input still fails loudly rather than
+ * silently becoming an empty filter, which on a people search is the difference
+ * between a scoped query and an unscoped firehose.
+ */
+import type { RunActionParams } from '@memberjunction/actions-base';
+/** A parse result: a value, or an error explaining what the value should have been. */
+export interface ParsedParam<T> {
+    value: T | undefined;
+    error: string | null;
+}
+/** Look up a param's raw value, unconverted. */
+export declare function getParamRaw(params: RunActionParams, name: string): unknown;
+/**
+ * Look up a param as a trimmed non-empty string, or null.
+ *
+ * Returns null for whitespace as well as for absent, so a required-field check
+ * treats `'   '` the way the caller meant it rather than passing a blank list
+ * name into a label lookup.
+ */
+export declare function getParam(params: RunActionParams, name: string): string | null;
+/**
+ * Normalize an optional array-of-strings param. Accepts a real array, a JSON
+ * array string, or a bare comma-separated string. Absent or empty yields
+ * `undefined` with no error — "not supplied" is a valid state for every filter
+ * that uses this.
+ */
+export declare function parseStringArrayParam(raw: unknown, name: string): ParsedParam<string[]>;
+/**
+ * Normalize an optional integer param. Accepts a number or a numeric string.
+ * Rejects non-integers rather than rounding: a page of 1.5 is a caller mistake,
+ * and silently reading page 1 would return plausible wrong data.
+ */
+export declare function parseOptionalIntegerParam(raw: unknown, name: string, options?: {
+    min?: number;
+    max?: number;
+}): ParsedParam<number>;
+/**
+ * Normalize an optional boolean param. Accepts a real boolean or the strings
+ * 'true'/'false', case-insensitive. Anything else is an error rather than a
+ * truthiness coercion — `'false'` is truthy in JavaScript, and treating it as
+ * `true` on a verify flag would be a silent, expensive surprise.
+ */
+export declare function parseOptionalBooleanParam(raw: unknown, name: string): ParsedParam<boolean>;
+/**
+ * The remediation tail appended whenever a list name does not resolve. Kept in
+ * one place so every action points the caller at the same next step.
+ */
+export declare const LIST_NOT_FOUND_HINT = "Run the Apollo Get Lists action to see the exact label names this Apollo account has.";
+//# sourceMappingURL=params.d.ts.map

package/dist/lists/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/lists/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEjF,uFAAuF;AACvF,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAwBvF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACrC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,CAAC,MAAM,CAAC,CAwBrB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAa1F;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,0FAC2D,CAAC"}