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

package/dist/lists/ApolloListActions.js

@@ -0,0 +1,135 @@
+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 label (list) actions: read the lists, and create one.
+ *
+ * Both need a MASTER Apollo key — the labels endpoints 403 on scoped keys, which
+ * is worth knowing before wiring these into a workflow, because the failure is
+ * indistinguishable from a bad key until you read the message.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { BaseAction } from '@memberjunction/actions';
+import { ApolloRESTBaseAction } from './ApolloRESTBaseAction.js';
+import { getParam } from './params.js';
+/**
+ * Lists the Apollo labels — lists and tags — with each one's kind
+ * ('accounts' | 'contacts') and cached member count.
+ *
+ * This is the first call in any list workflow, because every other action here
+ * addresses lists by exact name and this is what tells you the names. Read-only.
+ *
+ * Inputs:
+ *   - CompanyID (optional) resolve the key from this company's Apollo credential
+ *                          instead of APOLLO_API_KEY
+ *
+ * Outputs:
+ *   - Lists         array of { id, name, kind, cachedCount, createdAt, updatedAt }
+ *   - Count         number of labels
+ *   - KeySource     'credential' | 'environment' — which path supplied the key
+ */
+let ApolloGetListsAction = class ApolloGetListsAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const lists = await resolved.client.listLabels();
+            params.Params.push({ Name: 'Lists', Type: 'Output', Value: lists }, { Name: 'Count', Type: 'Output', Value: lists.length }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                Success: true,
+                Message: `Apollo lists: ${lists.length} label(s).`,
+                ResultCode: 'SUCCESS',
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloGetLists: ${msg}`);
+            return { Success: false, Message: `Error listing Apollo labels: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloGetListsAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloGetListsAction')
+], ApolloGetListsAction);
+export { ApolloGetListsAction };
+/**
+ * Creates an Apollo list (label), idempotently.
+ *
+ * The existing labels are read first, and a same-named label — matched
+ * case-insensitively — is returned as-is with `AlreadyExisted: true` rather than
+ * creating a second one. Apollo will happily create two labels with the same name,
+ * and once it has, every name-based lookup in this surface becomes ambiguous:
+ * `findLabelByName` returns whichever comes first, so half the moves would target
+ * one list and half the other. Making create idempotent is what keeps
+ * name-addressing sound.
+ *
+ * Master-key write.
+ *
+ * Inputs:
+ *   - ListName  (required) the label to create
+ *   - Modality  (optional) 'contacts' (default) | 'accounts' — Apollo rejects a
+ *                          create with no modality, so this is a real choice, not
+ *                          decoration: a contacts label cannot tag accounts
+ *   - CompanyID (optional) as above
+ *
+ * Outputs:
+ *   - ListID / ResolvedListName / AlreadyExisted / Modality / KeySource
+ */
+let ApolloCreateListAction = class ApolloCreateListAction extends ApolloRESTBaseAction {
+    async InternalRunAction(params) {
+        const listName = getParam(params, 'ListName');
+        if (!listName)
+            return this.MissingField('ListName');
+        const rawModality = getParam(params, 'Modality');
+        const modality = (rawModality ?? 'contacts').toLowerCase();
+        if (modality !== 'contacts' && modality !== 'accounts') {
+            return this.Invalid(`Modality must be 'contacts' or 'accounts' (got '${rawModality}').`);
+        }
+        const { resolved, error } = await this.ResolveClient(params);
+        if (error)
+            return error;
+        try {
+            const existingLabels = await resolved.client.listLabels();
+            const target = listName.toLowerCase();
+            const existing = existingLabels.find((l) => l.name.trim().toLowerCase() === target);
+            if (existing) {
+                LogStatus(`ApolloCreateList: label '${existing.name}' already exists (id ${existing.id}); not creating a duplicate.`);
+                params.Params.push({ Name: 'ListID', Type: 'Output', Value: existing.id }, { Name: 'ResolvedListName', Type: 'Output', Value: existing.name }, { Name: 'AlreadyExisted', Type: 'Output', Value: true }, { Name: 'Modality', Type: 'Output', Value: existing.kind }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+                return {
+                    Success: true,
+                    Message: `Apollo list '${existing.name}' already existed (id ${existing.id}); returned without creating a duplicate.`,
+                    ResultCode: 'SUCCESS',
+                    Params: params.Params,
+                };
+            }
+            const created = await resolved.client.createLabel(listName, modality);
+            LogStatus(`ApolloCreateList: created label '${created.name}' (id ${created.id}, modality ${modality}).`);
+            params.Params.push({ Name: 'ListID', Type: 'Output', Value: created.id }, { Name: 'ResolvedListName', Type: 'Output', Value: created.name }, { Name: 'AlreadyExisted', Type: 'Output', Value: false }, { Name: 'Modality', Type: 'Output', Value: created.kind }, { Name: 'KeySource', Type: 'Output', Value: resolved.key.source });
+            return {
+                Success: true,
+                Message: `Created Apollo list '${created.name}' (id ${created.id}).`,
+                ResultCode: 'SUCCESS',
+                Params: params.Params,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ApolloCreateList: ${msg}`);
+            return { Success: false, Message: `Error creating Apollo list: ${msg}`, ResultCode: 'ERROR' };
+        }
+    }
+};
+ApolloCreateListAction = __decorate([
+    RegisterClass(BaseAction, 'ApolloCreateListAction')
+], ApolloCreateListAction);
+export { ApolloCreateListAction };
+export function LoadApolloListActions() {
+    // Referenced by consumers to keep these registrations from being tree-shaken.
+}
+//# sourceMappingURL=ApolloListActions.js.map

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"}