@memberjunction/actions-apollo 6.1.0-edge.3 → 6.1.0-edge.5

package/dist/lists/ApolloListActions.js.map

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

package/dist/lists/ApolloMoveActions.d.ts

@@ -0,0 +1,33 @@
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { ApolloRESTBaseAction } from './ApolloRESTBaseAction.js';
+/**
+ * Moves accounts from one Apollo list to another.
+ *
+ * Inputs:
+ *   - AccountIDs (required) JSON array or comma-separated Apollo account ids
+ *   - FromList   (required) exact source label name
+ *   - ToList     (required) exact destination label name
+ *   - CompanyID  (optional) per-company credential resolution
+ *
+ * Outputs:
+ *   - MovedCount / FailedCount / PossiblyStuckCount
+ *   - Results          per-account { id, added, removed, possiblyStuck, error }
+ *   - NotOnSourcePage  supplied ids that were not on page 1 of the source list
+ *   - KeySource
+ *
+ * `PARTIAL_FAILURE` means at least one PATCH failed outright. Possibly-stuck
+ * records are NOT failures — the write succeeded and Apollo did not honour it.
+ */
+export declare class ApolloMoveListAccountsAction extends ApolloRESTBaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+/**
+ * Moves contacts from one Apollo list to another. Identical semantics to
+ * {@link ApolloMoveListAccountsAction}; the id param is `ContactIDs` and the
+ * outputs carry contact results.
+ */
+export declare class ApolloMoveListContactsAction extends ApolloRESTBaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+export declare function LoadApolloMoveActions(): void;
+//# sourceMappingURL=ApolloMoveActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApolloMoveActions.d.ts","sourceRoot":"","sources":["../../src/lists/ApolloMoveActions.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AA0IjE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,4BAA6B,SAAQ,oBAAoB;cAClD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwE1F;AAED;;;;GAIG;AACH,qBACa,4BAA6B,SAAQ,oBAAoB;cAClD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuE1F;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/lists/ApolloMoveActions.js

@@ -0,0 +1,272 @@
+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 list-move actions.
+ *
+ * A move is the only genuinely dangerous thing in this surface, so the two actions
+ * below are more cautious than their size suggests:
+ *
+ *   - Both list names are resolved to real labels BEFORE any write. A typo in
+ *     `ToList` that was only noticed halfway through would leave a batch split
+ *     across two lists with no record of which half moved.
+ *   - The source list is re-read to get each record's CURRENT labels. The caller
+ *     supplies ids, never labels: Apollo replaces the whole label array on every
+ *     update, so writing a stale set silently strips memberships the record picked
+ *     up since the caller last looked.
+ *   - Removes are verified, and records whose remove silently no-op'd are reported
+ *     rather than retried. Apollo fails this way on roughly 15-17% of removes and
+ *     an immediate retry flakes the same way; the next page-1 drain sees them
+ *     carrying both labels and finishes the job.
+ *
+ * Both require a MASTER Apollo key. There is no delete surface.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { BaseAction } from '@memberjunction/actions';
+import { ApolloRESTBaseAction } from './ApolloRESTBaseAction.js';
+import { LIST_NOT_FOUND_HINT, getParam, getParamRaw, parseStringArrayParam } from './params.js';
+/** Apollo's per-page maximum, which is also the widest source page a move can see. */
+const MOVE_SOURCE_PER_PAGE = 100;
+/**
+ * Validate the shared inputs. Identical `FromList`/`ToList` is rejected here
+ * rather than left to the client, so the caller gets a validation error instead of
+ * an exception out of the move engine.
+ */
+function parseMoveInputs(params, idsParamName) {
+    const idsParsed = parseStringArrayParam(getParamRaw(params, idsParamName), idsParamName);
+    if (idsParsed.error !== null) {
+        return { inputs: null, error: { Success: false, Message: idsParsed.error, ResultCode: 'VALIDATION_ERROR' } };
+    }
+    if (idsParsed.value === undefined) {
+        return {
+            inputs: null,
+            error: {
+                Success: false,
+                Message: `Missing required field: ${idsParamName} (JSON array or comma-separated Apollo ids)`,
+                ResultCode: 'MISSING_REQUIRED_FIELDS',
+            },
+        };
+    }
+    const fromList = getParam(params, 'FromList');
+    if (!fromList) {
+        return { inputs: null, error: { Success: false, Message: 'Missing required field: FromList', ResultCode: 'MISSING_REQUIRED_FIELDS' } };
+    }
+    const toList = getParam(params, 'ToList');
+    if (!toList) {
+        return { inputs: null, error: { Success: false, Message: 'Missing required field: ToList', ResultCode: 'MISSING_REQUIRED_FIELDS' } };
+    }
+    if (fromList.toLowerCase() === toList.toLowerCase()) {
+        return {
+            inputs: null,
+            error: {
+                Success: false,
+                Message: `FromList and ToList are identical ('${fromList}') — nothing to move.`,
+                ResultCode: 'VALIDATION_ERROR',
+            },
+        };
+    }
+    return { inputs: { ids: idsParsed.value, fromList, toList }, error: null };
+}
+/** Resolve both list names to labels before any write happens. */
+async function resolveBothLabels(client, fromList, toList) {
+    const from = await client.findLabelByName(fromList);
+    if (!from) {
+        return {
+            from: null,
+            to: null,
+            error: {
+                Success: false,
+                Message: `No Apollo list named '${fromList}' (FromList) was found. ${LIST_NOT_FOUND_HINT}`,
+                ResultCode: 'NOT_FOUND',
+            },
+        };
+    }
+    const to = await client.findLabelByName(toList);
+    if (!to) {
+        return {
+            from: null,
+            to: null,
+            error: {
+                Success: false,
+                Message: `No Apollo list named '${toList}' (ToList) was found. ${LIST_NOT_FOUND_HINT}`,
+                ResultCode: 'NOT_FOUND',
+            },
+        };
+    }
+    return { from, to, error: null };
+}
+/** The note appended when Apollo's silent-fail removes showed up. */
+function stuckNote(possiblyStuckCount, kind) {
+    return possiblyStuckCount > 0
+        ? ` ${possiblyStuckCount} ${kind} may be stuck — Apollo's remove reported success without applying. ` +
+            `They will resurface on the next page-1 drain carrying both labels; strip the source label then. ` +
+            `An immediate retry flakes the same way, which is why this action does not attempt one.`
+        : '';
+}
+/**
+ * Builds the caller-facing outcome, counting ids that were never ATTEMPTED as well as those that
+ * failed.
+ *
+ * This reads only page 1 of the source list, so ids beyond it land in `notOnSourcePage` and are
+ * silently skipped. The previous message was `Moved N of ${toMove.length}` where `toMove` counted
+ * only what page 1 contained — so passing 300 ids reported `Moved 100 of 100` with `Success: true`
+ * while 200 were never touched. `LogStatus` said so; the caller-facing result did not, and a caller
+ * acting on `Success` had no way to discover it.
+ *
+ * Skipped ids are therefore a PARTIAL_FAILURE, not a success: the caller asked for work that did not
+ * happen. `NotOnSourcePage` carries exactly which ones, so a retry is mechanical.
+ */
+function moveOutcome(result, attempted, requested, notOnSourcePage, from, to, kind) {
+    const skipped = notOnSourcePage.length;
+    const incomplete = result.failedCount > 0 || skipped > 0;
+    return {
+        // Reported against what the caller ASKED for, not against what page 1 happened to contain.
+        Success: !incomplete,
+        Message: `Moved ${result.movedCount} of ${requested} ${kind} from '${from}' to '${to}'` +
+            `${result.failedCount > 0 ? `; ${result.failedCount} failed` : ''}` +
+            `${skipped > 0
+                ? `; ${skipped} not on page 1 of '${from}' and NOT attempted — see NotOnSourcePage` +
+                    `${attempted !== requested ? ` (${attempted} attempted)` : ''}`
+                : ''}` +
+            `.${stuckNote(result.possiblyStuckCount, kind)}`,
+        ResultCode: incomplete ? 'PARTIAL_FAILURE' : 'SUCCESS',
+    };
+}
+/**
+ * Moves accounts from one Apollo list to another.
+ *
+ * Inputs:
+ *   - AccountIDs (required) JSON array or comma-separated Apollo account ids
+ *   - FromList   (required) exact source label name
+ *   - ToList     (required) exact destination label name
+ *   - CompanyID  (optional) per-company credential resolution
+ *
+ * Outputs:
+ *   - MovedCount / FailedCount / PossiblyStuckCount
+ *   - Results          per-account { id, added, removed, possiblyStuck, error }
+ *   - NotOnSourcePage  supplied ids that were not on page 1 of the source list
+ *   - KeySource
+ *
+ * `PARTIAL_FAILURE` means at least one PATCH failed outright. Possibly-stuck
+ * records are NOT failures — the write succeeded and Apollo did not honour it.
+ */
+let ApolloMoveListAccountsAction = class ApolloMoveListAccountsAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const parsed = parseMoveInputs(params, 'AccountIDs');
+        if (parsed.error)
+            return parsed.error;
+        const { ids, fromList, toList } = parsed.inputs;
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const labels = await resolveBothLabels(resolved.client, fromList, toList);
+            if (labels.error)
+                return labels.error;
+            // Re-read the source list to capture CURRENT labels — page 1, drain-safe.
+            const sourcePage = await resolved.client.searchAccounts({ labelIds: [labels.from.id] }, { page: 1, perPage: MOVE_SOURCE_PER_PAGE });
+            const byId = new Map(sourcePage.accounts.map((a) => [a.id, a]));
+            const toMove = [];
+            const notOnSourcePage = [];
+            for (const id of new Set(ids)) {
+                const account = byId.get(id);
+                if (account)
+                    toMove.push(account);
+                else
+                    notOnSourcePage.push(id);
+            }
+            if (toMove.length === 0) {
+                return {
+                    Success: false,
+                    Message: `None of the ${ids.length} supplied account id(s) were found on page 1 of '${labels.from.name}'. ` +
+                        `They may already have moved, or sit on a later page — re-read page 1, since removals shift pages.`,
+                    ResultCode: 'NOT_FOUND',
+                };
+            }
+            const result = await resolved.client.moveAccounts(toMove, labels.from.name, labels.to.name, { verify: true });
+            LogStatus(`ApolloMoveListAccounts: '${labels.from.name}' → '${labels.to.name}' — ${result.movedCount} moved, ` +
+                `${result.possiblyStuckCount} possibly stuck, ${result.failedCount} failed of ${toMove.length} ` +
+                `(${notOnSourcePage.length} supplied id(s) not on source page 1).`);
+            params.Params.push({ Name: 'MovedCount', Type: 'Output', Value: result.movedCount }, { Name: 'FailedCount', Type: 'Output', Value: result.failedCount }, { Name: 'PossiblyStuckCount', Type: 'Output', Value: result.possiblyStuckCount }, { Name: 'Results', Type: 'Output', Value: result.items }, { Name: 'NotOnSourcePage', Type: 'Output', Value: notOnSourcePage }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                ...moveOutcome(result, toMove.length, new Set(ids).size, notOnSourcePage, labels.from.name, labels.to.name, 'account(s)'),
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloMoveListAccounts: ${msg}`);
+            return { Success: false, Message: `Error moving Apollo accounts: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloMoveListAccountsAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloMoveListAccountsAction')
+], ApolloMoveListAccountsAction);
+export { ApolloMoveListAccountsAction };
+/**
+ * Moves contacts from one Apollo list to another. Identical semantics to
+ * {@link ApolloMoveListAccountsAction}; the id param is `ContactIDs` and the
+ * outputs carry contact results.
+ */
+let ApolloMoveListContactsAction = class ApolloMoveListContactsAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const parsed = parseMoveInputs(params, 'ContactIDs');
+        if (parsed.error)
+            return parsed.error;
+        const { ids, fromList, toList } = parsed.inputs;
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const labels = await resolveBothLabels(resolved.client, fromList, toList);
+            if (labels.error)
+                return labels.error;
+            const sourcePage = await resolved.client.searchContacts({ labelIds: [labels.from.id] }, { page: 1, perPage: MOVE_SOURCE_PER_PAGE });
+            const byId = new Map(sourcePage.contacts.map((c) => [c.id, c]));
+            const toMove = [];
+            const notOnSourcePage = [];
+            for (const id of new Set(ids)) {
+                const contact = byId.get(id);
+                if (contact)
+                    toMove.push(contact);
+                else
+                    notOnSourcePage.push(id);
+            }
+            if (toMove.length === 0) {
+                return {
+                    Success: false,
+                    Message: `None of the ${ids.length} supplied contact id(s) were found on page 1 of '${labels.from.name}'. ` +
+                        `They may already have moved, or sit on a later page — re-read page 1, since removals shift pages.`,
+                    ResultCode: 'NOT_FOUND',
+                };
+            }
+            const result = await resolved.client.moveContacts(toMove, labels.from.name, labels.to.name, { verify: true });
+            LogStatus(`ApolloMoveListContacts: '${labels.from.name}' → '${labels.to.name}' — ${result.movedCount} moved, ` +
+                `${result.possiblyStuckCount} possibly stuck, ${result.failedCount} failed of ${toMove.length} ` +
+                `(${notOnSourcePage.length} supplied id(s) not on source page 1).`);
+            params.Params.push({ Name: 'MovedCount', Type: 'Output', Value: result.movedCount }, { Name: 'FailedCount', Type: 'Output', Value: result.failedCount }, { Name: 'PossiblyStuckCount', Type: 'Output', Value: result.possiblyStuckCount }, { Name: 'Results', Type: 'Output', Value: result.items }, { Name: 'NotOnSourcePage', Type: 'Output', Value: notOnSourcePage }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                ...moveOutcome(result, toMove.length, new Set(ids).size, notOnSourcePage, labels.from.name, labels.to.name, 'contact(s)'),
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloMoveListContacts: ${msg}`);
+            return { Success: false, Message: `Error moving Apollo contacts: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloMoveListContactsAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloMoveListContactsAction')
+], ApolloMoveListContactsAction);
+export { ApolloMoveListContactsAction };
+export function LoadApolloMoveActions() {
+    // Referenced by consumers to keep these registrations from being tree-shaken.
+}
+//# sourceMappingURL=ApolloMoveActions.js.map

package/dist/lists/ApolloMoveActions.js.map

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

package/dist/lists/ApolloRESTBaseAction.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared plumbing for the Apollo list and search actions.
+ *
+ * Each of these actions does the same three things before it does anything
+ * interesting: resolve a key, build a client, and turn whatever went wrong into a
+ * result object rather than an exception. That lives here so seven actions cannot
+ * drift into seven different answers for "no credential configured".
+ *
+ * {@link CreateClient} is a protected seam purely so tests can substitute a fake
+ * client. Nothing in this package may reach api.apollo.io from a test: a live call
+ * would spend real credits, and the move surface would mutate a real Apollo
+ * account's list membership with no undo.
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import type { IApolloRESTClient } from '../generic/apollo-lists.types.js';
+import { type ResolvedApolloKey } from './credentials.js';
+/** A resolved client plus how its key was found. */
+export interface ResolvedApolloClient {
+    client: IApolloRESTClient;
+    key: ResolvedApolloKey;
+}
+export declare abstract class ApolloRESTBaseAction extends BaseAction {
+    /**
+     * Build the client. Overridden in tests; the only place `ApolloRESTClient` is
+     * constructed in this surface.
+     */
+    protected CreateClient(apiKey: string): IApolloRESTClient;
+    /**
+     * Resolve the key and construct the client, or return the failure result to
+     * hand straight back to the caller.
+     *
+     * `CompanyID` is optional here, unlike in the CDP actions this ports from,
+     * because a single-tenant instance with `APOLLO_API_KEY` set has no company
+     * to name. Supplying it switches on the per-company credential path.
+     */
+    protected ResolveClient(params: RunActionParams): Promise<{
+        resolved: ResolvedApolloClient;
+        error: null;
+    } | {
+        resolved: null;
+        error: ActionResultSimple;
+    }>;
+    /** A uniform missing-input failure. */
+    protected MissingField(name: string, detail?: string): ActionResultSimple;
+    /** A uniform validation failure. */
+    protected Invalid(message: string): ActionResultSimple;
+}
+//# sourceMappingURL=ApolloRESTBaseAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApolloRESTBaseAction.d.ts","sourceRoot":"","sources":["../../src/lists/ApolloRESTBaseAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGtG,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,iBAAiB,CAAC;CAC1B;AAED,8BAAsB,oBAAqB,SAAQ,UAAU;IACzD;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAIzD;;;;;;;OAOG;cACa,aAAa,CACzB,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC;QAAE,QAAQ,EAAE,oBAAoB,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAuB3G,uCAAuC;IACvC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAQzE,oCAAoC;IACpC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB;CAGzD"}

package/dist/lists/ApolloRESTBaseAction.js

@@ -0,0 +1,70 @@
+/**
+ * Shared plumbing for the Apollo list and search actions.
+ *
+ * Each of these actions does the same three things before it does anything
+ * interesting: resolve a key, build a client, and turn whatever went wrong into a
+ * result object rather than an exception. That lives here so seven actions cannot
+ * drift into seven different answers for "no credential configured".
+ *
+ * {@link CreateClient} is a protected seam purely so tests can substitute a fake
+ * client. Nothing in this package may reach api.apollo.io from a test: a live call
+ * would spend real credits, and the move surface would mutate a real Apollo
+ * account's list membership with no undo.
+ */
+import { BaseAction } from '@memberjunction/actions';
+import { ApolloRESTClient } from './ApolloRESTClient.js';
+import { NO_APOLLO_KEY_MESSAGE, resolveApolloAPIKey } from './credentials.js';
+import { getParam } from './params.js';
+export class ApolloRESTBaseAction extends BaseAction {
+    /**
+     * Build the client. Overridden in tests; the only place `ApolloRESTClient` is
+     * constructed in this surface.
+     */
+    CreateClient(apiKey) {
+        return new ApolloRESTClient(apiKey);
+    }
+    /**
+     * Resolve the key and construct the client, or return the failure result to
+     * hand straight back to the caller.
+     *
+     * `CompanyID` is optional here, unlike in the CDP actions this ports from,
+     * because a single-tenant instance with `APOLLO_API_KEY` set has no company
+     * to name. Supplying it switches on the per-company credential path.
+     */
+    async ResolveClient(params) {
+        const companyID = getParam(params, 'CompanyID');
+        let key;
+        try {
+            key = await resolveApolloAPIKey(companyID, params.ContextUser);
+        }
+        catch (error) {
+            // A credential that exists but is malformed — say so, rather than
+            // falling back to a different workspace's key from the environment.
+            return {
+                resolved: null,
+                error: {
+                    Success: false,
+                    Message: error instanceof Error ? error.message : String(error),
+                    ResultCode: 'CONFIGURATION_ERROR',
+                },
+            };
+        }
+        if (!key) {
+            return { resolved: null, error: { Success: false, Message: NO_APOLLO_KEY_MESSAGE, ResultCode: 'CREDENTIALS_NOT_FOUND' } };
+        }
+        return { resolved: { client: this.CreateClient(key.apiKey), key }, error: null };
+    }
+    /** A uniform missing-input failure. */
+    MissingField(name, detail) {
+        return {
+            Success: false,
+            Message: `Missing required field: ${name}${detail ? ` (${detail})` : ''}`,
+            ResultCode: 'MISSING_REQUIRED_FIELDS',
+        };
+    }
+    /** A uniform validation failure. */
+    Invalid(message) {
+        return { Success: false, Message: message, ResultCode: 'VALIDATION_ERROR' };
+    }
+}
+//# sourceMappingURL=ApolloRESTBaseAction.js.map

package/dist/lists/ApolloRESTBaseAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApolloRESTBaseAction.js","sourceRoot":"","sources":["../../src/lists/ApolloRESTBaseAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAA0B,MAAM,kBAAkB,CAAC;AACtG,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,MAAM,OAAgB,oBAAqB,SAAQ,UAAU;IACzD;;;OAGG;IACO,YAAY,CAAC,MAAc;QACjC,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,aAAa,CACzB,MAAuB;QAEvB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,GAA6B,CAAC;QAClC,IAAI,CAAC;YACD,GAAG,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,kEAAkE;YAClE,oEAAoE;YACpE,OAAO;gBACH,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACH,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC/D,UAAU,EAAE,qBAAqB;iBACpC;aACJ,CAAC;QACN,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,uBAAuB,EAAE,EAAE,CAAC;QAC9H,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACrF,CAAC;IAED,uCAAuC;IAC7B,YAAY,CAAC,IAAY,EAAE,MAAe;QAChD,OAAO;YACH,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,2BAA2B,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzE,UAAU,EAAE,yBAAyB;SACxC,CAAC;IACN,CAAC;IAED,oCAAoC;IAC1B,OAAO,CAAC,OAAe;QAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAChF,CAAC;CACJ"}

package/dist/lists/ApolloRESTClient.d.ts

@@ -0,0 +1,136 @@
+import type { ApolloAccount, ApolloAccountSearchFilter, ApolloAccountsPage, ApolloContact, ApolloContactSearchFilter, ApolloContactsPage, ApolloLabel, ApolloMoveResult, ApolloPagingOptions, ApolloPeoplePage, ApolloPeopleSearchFilter, IApolloRESTClient } from '../generic/apollo-lists.types.js';
+/** Options for {@link ApolloRESTClient}. */
+export interface ApolloRESTClientOptions {
+    /**
+     * Injected fetch, for tests. Tests must never reach api.apollo.io — a live
+     * call would consume real credits and mutate a real account's lists.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Apollo.io list/search client. See the module doc, and the quirk list on
+ * `apollo-lists.types.ts`, for the behaviours it encodes.
+ */
+export declare class ApolloRESTClient implements IApolloRESTClient {
+    private readonly apiKey;
+    private readonly fetchImpl;
+    /**
+     * The label id↔name maps, built on first use and cached for the instance
+     * lifetime (quirk #5). One labels call per client, shared by every search and
+     * move. No TTL: a single drain or move operation uses one instance, and
+     * labels do not churn mid-operation. Construct a new client to see label
+     * changes made since.
+     */
+    private labelMaps;
+    constructor(apiKey: string, options?: ApolloRESTClientOptions);
+    /**
+     * Issue one request and return the parsed body. A non-2xx throws with the
+     * method, path, status and whatever detail Apollo supplied; a 403 on a
+     * master-key operation throws the master-key explanation instead (quirk #4).
+     * Nothing is swallowed — a body that will not parse still surfaces its text.
+     */
+    private request;
+    /**
+     * Every label, account lists and contact lists alike. Master key required.
+     * Apollo returns either a bare array or a `{ labels: [...] }` envelope
+     * depending on the account; both are accepted.
+     */
+    listLabels(): Promise<ApolloLabel[]>;
+    /**
+     * Create a label. Master key required.
+     *
+     * `modality` is not optional to Apollo despite reading like it should be:
+     * posting without it returns HTTP 422 "Please enter a non-empty modality!".
+     * It defaults to 'contacts' here because a people list is the common case.
+     *
+     * The create response shape is not pinned in Apollo's docs, so a bare label
+     * object, a `{ label: {...} }` envelope and a `{ labels: [...] }` envelope
+     * are all accepted — mirroring how {@link listLabels} tolerates two read
+     * shapes. A shape none of those match throws rather than returning a label
+     * with an empty id, which would then be written into a membership array.
+     */
+    createLabel(name: string, modality?: 'contacts' | 'accounts'): Promise<ApolloLabel>;
+    /**
+     * Resolve a label by exact name, case-insensitive; null when nothing matches.
+     * This is how a human-supplied list name becomes the id a search filter needs.
+     */
+    findLabelByName(name: string): Promise<ApolloLabel | null>;
+    /**
+     * Build (once per instance) the id↔name maps that resolve search-response
+     * `label_ids` into names (quirk #5). When two labels share a name — rare — the
+     * last one wins in `nameToId`.
+     */
+    private getLabelMaps;
+    /** One aggregated warning for label ids that did not resolve to a name (quirk #5). */
+    private warnUnresolvedLabels;
+    /**
+     * One page of saved accounts. Paging defaults to page 1 — when draining a
+     * list, never advance (quirk #3).
+     */
+    searchAccounts(filter: ApolloAccountSearchFilter, paging?: ApolloPagingOptions): Promise<ApolloAccountsPage>;
+    /** One page of saved contacts. Same drain-page-1 default as {@link searchAccounts}. */
+    searchContacts(filter: ApolloContactSearchFilter, paging?: ApolloPagingOptions): Promise<ApolloContactsPage>;
+    /**
+     * One page of prospecting people — net-new, not your saved contacts. Apollo
+     * does not return emails or phones here by design.
+     *
+     * Unlike the two searches above, this one does not need the label maps: the
+     * prospecting response carries no memberships, so fetching them would be a
+     * wasted master-key call on a read a scoped key can otherwise serve.
+     */
+    searchPeople(filter: ApolloPeopleSearchFilter, paging?: ApolloPagingOptions): Promise<ApolloPeoplePage>;
+    /**
+     * Replace one account's label set with `labelNames` — which must be the
+     * COMPLETE intended set, because Apollo overwrites wholesale (quirk #1).
+     * Master key required.
+     */
+    private updateAccountLabels;
+    /** The same for one contact. Identical full-replace and master-key semantics. */
+    private updateContactLabels;
+    /**
+     * Re-read one account's current labels for the verify pass (quirk #2), by
+     * searching the destination list and matching on id. Null when the record is
+     * not on that page, which is not the same as "the remove worked" — hence
+     * `possiblyStuck` stays null rather than becoming false.
+     */
+    private readAccountLabels;
+    private readContactLabels;
+    /**
+     * The ADD phase's label set: current ∪ {toList}. Idempotent — adding a label
+     * the record already carries is a set no-op, so re-running a partial move
+     * does not duplicate anything.
+     */
+    private addPhaseLabels;
+    /**
+     * The REMOVE phase's label set: (current ∪ {toList}) \ {fromList}.
+     *
+     * It is computed from the post-add state rather than from `current` so that
+     * the destination label survives the second write. Deriving it from `current`
+     * alone would add the record to the destination and then immediately take it
+     * back out.
+     */
+    private removePhaseLabels;
+    /**
+     * The move engine, shared by accounts and contacts through the injected
+     * update/read closures so the label-preservation math and the stuck detection
+     * exist in exactly one place.
+     */
+    private moveRecords;
+    /**
+     * Move accounts between lists. The supplied accounts must carry current
+     * `labelNames` from a fresh {@link searchAccounts} read — this method writes
+     * whatever it is given as the intended set, so stale labels here mean real
+     * memberships silently disappear.
+     *
+     * With `verify`, the destination list is re-read after each remove to flag
+     * silent-fail records. Never deletes, never auto-retries.
+     */
+    moveAccounts(accounts: ApolloAccount[], fromList: string, toList: string, options?: {
+        verify?: boolean;
+    }): Promise<ApolloMoveResult>;
+    /** Move contacts between lists. Same two-step and verify semantics as accounts. */
+    moveContacts(contacts: ApolloContact[], fromList: string, toList: string, options?: {
+        verify?: boolean;
+    }): Promise<ApolloMoveResult>;
+}
+//# sourceMappingURL=ApolloRESTClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApolloRESTClient.d.ts","sourceRoot":"","sources":["../../src/lists/ApolloRESTClient.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EACR,aAAa,EACb,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,yBAAyB,EACzB,kBAAkB,EAClB,WAAW,EAEX,gBAAgB,EAEhB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EAExB,iBAAiB,EACpB,MAAM,kCAAkC,CAAC;AAO1C,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC5B;AA+GD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,CAA0B;gBAE/B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAW7D;;;;;OAKG;YACW,OAAO;IAgErB;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiBjD;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,UAAU,GAAG,UAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoC5G;;;OAGG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASvE;;;;OAIG;YACW,YAAY;IAmB1B,sFAAsF;IACtF,OAAO,CAAC,oBAAoB;IAW5B;;;OAGG;IACU,cAAc,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmBzH,uFAAuF;IAC1E,cAAc,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBzH;;;;;;;OAOG;IACU,YAAY,CAAC,MAAM,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBpH;;;;OAIG;YACW,mBAAmB;IAajC,iFAAiF;YACnE,mBAAmB;IAajC;;;;;OAKG;YACW,iBAAiB;YAOjB,iBAAiB;IAO/B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;YACW,WAAW;IAqFzB;;;;;;;;OAQG;IACU,YAAY,CACrB,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAgB5B,mFAAmF;IACtE,YAAY,CACrB,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,gBAAgB,CAAC;CAc/B"}