@myapihq/sdk 2.22.0 → 2.23.0

package/dist/crm.d.ts

@@ -116,6 +116,43 @@ export declare function deleteContact(apiKey: string, orgId: string, id: string)
 export declare function restoreContact(apiKey: string, orgId: string, id: string): Promise<Contact>;
 export declare function searchContacts(apiKey: string, orgId: string, filter?: ContactSearchFilter): Promise<ContactSearchResult>;
 export declare function promoteContact(apiKey: string, orgId: string, goldfoxPersonId: string): Promise<Contact>;
+/** One page of a bulk promotion: what it did, and where to resume. */
+export interface PromoteAudienceResult {
+    audience_id: string;
+    created: number;
+    matched: number;
+    /** Goldfox rows with no address — the usual reason 400 becomes 260. */
+    skipped_no_email: number;
+    failed: number;
+    processed: number;
+    offset: number;
+    total: number;
+    has_more: boolean;
+    next_offset: number;
+    note: string;
+}
+export declare function promoteAudience(apiKey: string, orgId: string, audienceId: string, opts?: {
+    limit?: number;
+    offset?: number;
+}): Promise<PromoteAudienceResult>;
+/** A row the import could not use, with the reason and the line it was on. */
+export interface SkippedImportRow {
+    line: number;
+    email?: string;
+    /** e.g. "no email", "not an address", "previously deleted". */
+    reason: string;
+}
+export interface ImportContactsResult {
+    created: number;
+    /** Already in CRM: matched, never overwritten. A soft-deleted address is
+     *  NOT counted here — it comes back as a skipped row, since nothing was
+     *  imported and the person is not present. */
+    matched: number;
+    skipped: number;
+    skipped_rows: SkippedImportRow[];
+    note: string;
+}
+export declare function importContacts(apiKey: string, orgId: string, csv: Blob | Buffer | string, filename?: string): Promise<ImportContactsResult>;
 export declare function getContactEvents(apiKey: string, orgId: string, id: string, opts?: ListEventsOptions): Promise<EventsResponse>;
 export declare function createCompany(apiKey: string, orgId: string, input: CreateCompanyInput): Promise<Company>;
 export declare function getCompany(apiKey: string, orgId: string, id: string): Promise<Company>;

package/dist/crm.js

@@ -8,6 +8,8 @@ exports.deleteContact = deleteContact;
 exports.restoreContact = restoreContact;
 exports.searchContacts = searchContacts;
 exports.promoteContact = promoteContact;
+exports.promoteAudience = promoteAudience;
+exports.importContacts = importContacts;
 exports.getContactEvents = getContactEvents;
 exports.createCompany = createCompany;
 exports.getCompany = getCompany;
@@ -21,6 +23,8 @@ const config_1 = require("./config");
 exports.EXPOSES = [
     'POST /crm/orgs/{org_id}/contacts',
     'POST /crm/orgs/{org_id}/contacts/promote',
+    'POST /crm/orgs/{org_id}/contacts/promote-audience',
+    'POST /crm/orgs/{org_id}/contacts/import',
     'POST /crm/orgs/{org_id}/contacts/search',
     'GET /crm/orgs/{org_id}/contacts/{id}',
     'PATCH /crm/orgs/{org_id}/contacts/{id}',
@@ -61,6 +65,37 @@ async function searchContacts(apiKey, orgId, filter = {}) {
 async function promoteContact(apiKey, orgId, goldfoxPersonId) {
     return (0, client_1.request)('POST', `${config_1.CRM_BASE}/crm/orgs/${encodeURIComponent(orgId)}/contacts/promote`, apiKey, { goldfox_person_id: goldfoxPersonId });
 }
+// Promotes ONE page. Idempotent, so resuming or repeating a page costs a
+// match rather than a duplicate of somebody with the same address.
+async function promoteAudience(apiKey, orgId, audienceId, opts) {
+    return (0, client_1.request)('POST', `${config_1.CRM_BASE}/crm/orgs/${encodeURIComponent(orgId)}/contacts/promote-audience`, apiKey, {
+        audience_id: audienceId, limit: opts?.limit, offset: opts?.offset,
+    });
+}
+// Multipart, mirroring the container source upload. The server needs a `file`
+// part; a raw CSV body is rejected with FILE_REQUIRED.
+async function importContacts(apiKey, orgId, csv, filename = 'contacts.csv') {
+    const formData = new FormData();
+    const blob = typeof csv === 'string'
+        ? new Blob([csv], { type: 'text/csv' })
+        : new Blob([csv], { type: 'text/csv' });
+    formData.append('file', blob, filename);
+    const response = await fetch(`${config_1.CRM_BASE}/crm/orgs/${encodeURIComponent(orgId)}/contacts/import`, { method: 'POST', headers: { Authorization: `Bearer ${apiKey}` }, body: formData });
+    let result;
+    try {
+        result = await response.json();
+    }
+    catch {
+        throw new client_1.MyApiError('invalid_json_response', response.status);
+    }
+    if (!response.ok || !result?.success) {
+        const err = result?.error;
+        const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
+        const detail = typeof err === 'object' ? err?.message : undefined;
+        throw new client_1.MyApiError(code, response.status, detail, typeof err === 'object' ? err : undefined);
+    }
+    return result.data;
+}
 async function getContactEvents(apiKey, orgId, id, opts = {}) {
     const qs = new URLSearchParams();
     if (opts.limit != null)

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.22.0";
+export declare const SDK_VERSION = "2.23.0";

package/dist/version.js

@@ -8,4 +8,4 @@ exports.SDK_VERSION = void 0;
 // Why a constant and not a package.json read: the SDK runs inside edge
 // functions (Cloudflare Workers), so it must not import node:fs. A literal
 // is the only version source that works in every runtime we ship to.
-exports.SDK_VERSION = '2.22.0';
+exports.SDK_VERSION = '2.23.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/sdk",
   "license": "Apache-2.0",
-  "version": "2.22.0",
+  "version": "2.23.0",
   "description": "TypeScript SDK for the MyAPI ecosystem",
   "repository": {
     "type": "git",