@myapihq/sdk 1.1.0-wip.4 → 1.2.0

package/dist/email-verify.d.ts

@@ -0,0 +1,30 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
+export type VerifyVerdict = 'deliverable' | 'undeliverable' | 'unknown';
+export interface VerifyChecks {
+    syntax: {
+        valid: boolean;
+        detail?: string;
+    };
+    dns?: {
+        valid: boolean;
+        mx_records?: string[];
+    };
+    microsoft?: {
+        verdict: string;
+        if_exists_result: number;
+        domain_type: number;
+        federated: boolean;
+    };
+}
+export interface VerifyResult {
+    email: string;
+    verdict: VerifyVerdict;
+    confidence: number;
+    smtp_recommended: boolean;
+    checks: VerifyChecks;
+    elapsed_ms: number;
+}
+export declare function verifyEmail(apiKey: string, orgId: string, { email }: {
+    email: string;
+}): Promise<VerifyResult>;

package/dist/email-verify.js

@@ -0,0 +1,17 @@
+"use strict";
+// Scaffolded from schema by scripts/scaffold-sdk.js — DO NOT remove the
+// EXPOSES array (the coverage tool verifies it against the live schema).
+// Types and function names ARE editable; re-running the scaffolder against
+// a service whose config has been changed will diff vs. existing file
+// (use --dry-run to inspect).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
+exports.verifyEmail = verifyEmail;
+const client_1 = require("./client");
+const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /email-verify/orgs/{org_id}/verify',
+];
+async function verifyEmail(apiKey, orgId, { email }) {
+    return (0, client_1.request)('POST', `${config_1.EMAIL_VERIFY_BASE}/email-verify/orgs/${encodeURIComponent(orgId)}/verify`, apiKey, { email });
+}

package/dist/email.d.ts

@@ -1,3 +1,5 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
 export interface EmailMessage {
     message_id: string;
     from: string;
@@ -52,6 +54,32 @@ export interface CampaignStats {
         page_visits: number;
     };
 }
+export type VerifyVerdict = 'deliverable' | 'undeliverable' | 'unknown';
+export interface VerifyChecks {
+    syntax: {
+        valid: boolean;
+        detail?: string;
+    };
+    dns?: {
+        valid: boolean;
+        mx_records?: string[];
+    };
+    microsoft?: {
+        verdict: string;
+        if_exists_result: number;
+        domain_type: number;
+        federated: boolean;
+    };
+}
+export interface VerifyResult {
+    email: string;
+    verdict: VerifyVerdict;
+    confidence: number;
+    smtp_recommended: boolean;
+    checks: VerifyChecks;
+    elapsed_ms: number;
+}
+export declare function verifyEmail(apiKey: string, orgId: string, email: string): Promise<VerifyResult>;
 export declare function createMailbox(apiKey: string, domain: string, username: string, displayName?: string): Promise<{
     address: string;
     created_at: string;
@@ -117,6 +145,11 @@ export declare function getTemplateJobStatus(apiKey: string, orgId: string, jobI
     };
 }>;
 export declare function getTemplate(apiKey: string, orgId: string, templateId: string): Promise<EmailTemplate>;
+export declare function getTemplatePreview(templateId: string): Promise<{
+    html?: string;
+    subject?: string;
+    preview_url?: string;
+} & Record<string, unknown>>;
 export declare function editTemplate(apiKey: string, orgId: string, templateId: string, prompt: string): Promise<{
     template_id: string;
     preview_url: string;

package/dist/email.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
+exports.verifyEmail = verifyEmail;
 exports.createMailbox = createMailbox;
 exports.listMailboxes = listMailboxes;
 exports.activateSending = activateSending;
@@ -17,6 +19,7 @@ exports.getWarmupStats = getWarmupStats;
 exports.generateTemplate = generateTemplate;
 exports.getTemplateJobStatus = getTemplateJobStatus;
 exports.getTemplate = getTemplate;
+exports.getTemplatePreview = getTemplatePreview;
 exports.editTemplate = editTemplate;
 exports.sendTestEmail = sendTestEmail;
 exports.listTemplates = listTemplates;
@@ -34,6 +37,51 @@ exports.getCampaign = getCampaign;
 exports.updateCampaign = updateCampaign;
 const client_1 = require("./client");
 const config_1 = require("./config");
+exports.EXPOSES = [
+    // Mailbox / sending activation
+    'POST /email/mailboxes/create',
+    'GET /email/mailboxes',
+    'POST /email/sending/activate',
+    // Send + read
+    'POST /email/send',
+    'GET /email/status/{message_id}',
+    'GET /email/sent',
+    'GET /email/inbox/{address}',
+    'GET /email/outbox/{address}',
+    'GET /email/message/{message_id}',
+    // Warmup
+    'POST /email/warmup/start',
+    'POST /email/warmup/pause',
+    'POST /email/warmup/resume',
+    'POST /email/warmup/stop',
+    'GET /email/warmup/stats/{address}',
+    // Templates
+    'POST /email/orgs/{org_id}/templates/generate',
+    'GET /email/orgs/{org_id}/template-jobs/{job_id}',
+    'GET /email/orgs/{org_id}/templates',
+    'GET /email/orgs/{org_id}/templates/{template_id}',
+    'POST /email/orgs/{org_id}/templates/{template_id}/edit',
+    'POST /email/orgs/{org_id}/templates/{template_id}/send-test',
+    'DELETE /email/orgs/{org_id}/templates/{template_id}',
+    'GET /email/templates/{template_id}/preview',
+    // Campaigns
+    'POST /email/orgs/{org_id}/campaigns',
+    'GET /email/orgs/{org_id}/campaigns',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}',
+    'PATCH /email/orgs/{org_id}/campaigns/{campaign_id}',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/upload-list',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/upload-file',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/status',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/start',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/pause',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/resume',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}/stats',
+    // Verify
+    'POST /email/orgs/{org_id}/verify',
+];
+async function verifyEmail(apiKey, orgId, email) {
+    return (0, client_1.request)('POST', `${config_1.EMAIL_BASE}/email/orgs/${encodeURIComponent(orgId)}/verify`, apiKey, { email });
+}
 // ── Mailbox ops (account-scoped) ─────────────────────────────────────────────
 async function createMailbox(apiKey, domain, username, displayName) {
     return (0, client_1.request)('POST', `${config_1.EMAIL_BASE}/email/mailboxes/create`, apiKey, { domain, username, display_name: displayName });
@@ -95,6 +143,11 @@ async function getTemplateJobStatus(apiKey, orgId, jobId) {
 async function getTemplate(apiKey, orgId, templateId) {
     return (0, client_1.request)('GET', `${config_1.EMAIL_BASE}/email/orgs/${encodeURIComponent(orgId)}/templates/${encodeURIComponent(templateId)}`, apiKey);
 }
+// Public preview — no auth required. The endpoint is unauthenticated per
+// the OpenAPI schema; access is gated by the unguessable template_id.
+async function getTemplatePreview(templateId) {
+    return (0, client_1.request)('GET', `${config_1.EMAIL_BASE}/email/templates/${encodeURIComponent(templateId)}/preview`, undefined);
+}
 async function editTemplate(apiKey, orgId, templateId, prompt) {
     return (0, client_1.request)('POST', `${config_1.EMAIL_BASE}/email/orgs/${encodeURIComponent(orgId)}/templates/${encodeURIComponent(templateId)}/edit`, apiKey, { prompt });
 }

package/dist/exposes.d.ts

@@ -0,0 +1,2 @@
+export type Endpoint = `${'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE'} /${string}`;
+export type Exposes = readonly Endpoint[];

package/dist/exposes.js

@@ -0,0 +1,14 @@
+"use strict";
+// OpenAPI-templated endpoint declaration for SDK service modules.
+//
+// Each service module (hq, domain, funnel, ...) exports an `EXPOSES: Exposes`
+// array listing the backend endpoints reachable through that module's
+// functions. The integrations coverage tool walks these to verify CLI ↔ SDK
+// parity (S-108).
+//
+// Form: `<METHOD> <PATH>` where path uses `{name}` for variable segments
+// matching OpenAPI 3.x style.
+//
+// Mirrors packages/cli/src/exposes.ts — kept duplicated to avoid runtime
+// dependencies between the packages (the SDK has zero runtime deps per NFR-005).
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/funnel.d.ts

@@ -1,3 +1,5 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
 export interface Funnel {
     id: string;
     org_id: string;
@@ -32,6 +34,14 @@ export declare function pushFunnelPage(apiKey: string, orgId: string, funnelId:
 }): Promise<{
     url: string;
 }>;
+export interface FunnelPage {
+    slug: string;
+    url?: string;
+    published_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+export declare function listFunnelPages(apiKey: string, orgId: string, funnelId: string): Promise<FunnelPage[]>;
 export declare function verifyFunnel(apiKey: string, orgId: string, funnelId: string, opts?: {
     html?: string;
     slug?: string;

package/dist/funnel.js

@@ -1,13 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
 exports.createFunnel = createFunnel;
 exports.getFunnel = getFunnel;
 exports.listFunnels = listFunnels;
 exports.deleteFunnel = deleteFunnel;
 exports.pushFunnelPage = pushFunnelPage;
+exports.listFunnelPages = listFunnelPages;
 exports.verifyFunnel = verifyFunnel;
 const client_1 = require("./client");
 const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /funnel/orgs/{org_id}/funnels',
+    'GET /funnel/orgs/{org_id}/funnels',
+    'GET /funnel/orgs/{org_id}/funnels/{funnel_id}',
+    'DELETE /funnel/orgs/{org_id}/funnels/{funnel_id}',
+    'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/push-page',
+    'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/verify',
+    'GET /funnel/orgs/{org_id}/funnels/{funnel_id}/pages',
+];
 async function createFunnel(apiKey, orgId) {
     return (0, client_1.request)('POST', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey, {});
 }
@@ -23,6 +34,15 @@ async function deleteFunnel(apiKey, orgId, funnelId) {
 async function pushFunnelPage(apiKey, orgId, funnelId, payload) {
     return (0, client_1.request)('POST', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/push-page`, apiKey, payload);
 }
+async function listFunnelPages(apiKey, orgId, funnelId) {
+    // Backend returns `{ pages: [...] }` for this endpoint (every other list
+    // endpoint returns a flat array). Unwrap so the SDK's contract matches the
+    // rest — callers expect an array.
+    const res = await (0, client_1.request)('GET', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/pages`, apiKey);
+    if (Array.isArray(res))
+        return res;
+    return res?.pages ?? [];
+}
 async function verifyFunnel(apiKey, orgId, funnelId, opts) {
     return (0, client_1.request)('POST', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}/verify`, apiKey, opts || {});
 }

package/dist/hq.d.ts

@@ -1,3 +1,5 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
 export interface Org {
     id: string;
     name: string;
@@ -44,6 +46,14 @@ export declare function createAnonymousAccount(): Promise<AuthResult & {
 export declare function sendCode(email: string): Promise<void>;
 export declare function verifyCode(email: string, code: string): Promise<AuthResult>;
 export declare function upgradeAccount(apiKey: string, email: string): Promise<AuthResult>;
+export type FreeTierEntry = {
+    service: string;
+    used: number;
+    allowance: number;
+    remaining?: number;
+    reset_at?: string;
+};
+export declare function getFreeTier(apiKey: string): Promise<FreeTierEntry[] | null>;
 export declare function getAccount(apiKey: string): Promise<AccountInfo>;
 export declare function createApiKey(apiKey: string, name: string): Promise<{
     api_key: string;

package/dist/hq.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
 exports.createAnonymousAccount = createAnonymousAccount;
 exports.sendCode = sendCode;
 exports.verifyCode = verifyCode;
 exports.upgradeAccount = upgradeAccount;
+exports.getFreeTier = getFreeTier;
 exports.getAccount = getAccount;
 exports.createApiKey = createApiKey;
 exports.listApiKeys = listApiKeys;
@@ -22,6 +24,29 @@ exports.setupPayment = setupPayment;
 exports.topUp = topUp;
 const client_1 = require("./client");
 const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /hq/account/anonymous',
+    'POST /hq/account/send-code',
+    'POST /hq/account/verify-code',
+    'PATCH /hq/account/upgrade',
+    'GET /hq/account/me',
+    'GET /hq/account/free-tier',
+    'POST /hq/account/create/key',
+    'GET /hq/account/keys',
+    'DELETE /hq/account/delete/key/{key_id}',
+    'POST /hq/orgs',
+    'GET /hq/orgs',
+    'GET /hq/orgs/{org_id}',
+    'PATCH /hq/orgs/{org_id}',
+    'DELETE /hq/orgs/{org_id}',
+    'POST /hq/org-imports',
+    'GET /hq/org-imports/{import_id}',
+    'POST /hq/org-imports/{import_id}/confirm',
+    'GET /hq/billing/balance',
+    'GET /hq/billing/history',
+    'POST /hq/billing/setup-payment',
+    'POST /hq/billing/topup',
+];
 async function createAnonymousAccount() {
     return (0, client_1.request)('POST', `${config_1.HQ_BASE}/hq/account/anonymous`, undefined, {});
 }
@@ -34,6 +59,9 @@ async function verifyCode(email, code) {
 async function upgradeAccount(apiKey, email) {
     return (0, client_1.request)('PATCH', `${config_1.HQ_BASE}/hq/account/upgrade`, apiKey, { email });
 }
+async function getFreeTier(apiKey) {
+    return (0, client_1.request)('GET', `${config_1.HQ_BASE}/hq/account/free-tier`, apiKey);
+}
 async function getAccount(apiKey) {
     return (0, client_1.request)('GET', `${config_1.HQ_BASE}/hq/account/me`, apiKey);
 }

package/dist/image.d.ts

@@ -1,3 +1,15 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
+export interface ImageModel {
+    id: string;
+    kind: 'image';
+    aspect_ratios: string[];
+    default_size: string;
+    cost_per_image_usd: number;
+}
+export interface ImageModelsResponse {
+    models: ImageModel[];
+}
 export interface ImageJob {
     job_id: string;
     status: 'pending' | 'processing' | 'completed' | 'failed';
@@ -9,6 +21,7 @@ export interface ImageJob {
 }
 export declare function generateImage(apiKey: string, orgId: string, payload: {
     prompt: string;
+    model?: string;
     aspect_ratio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4';
     style?: string;
     colors?: string;
@@ -20,3 +33,4 @@ export declare function generateImage(apiKey: string, orgId: string, payload: {
 export declare function getImageJob(apiKey: string, orgId: string, jobId: string): Promise<ImageJob>;
 export declare function listImages(apiKey: string, orgId: string): Promise<ImageJob[]>;
 export declare function deleteImage(apiKey: string, orgId: string, jobId: string): Promise<void>;
+export declare function listModels(apiKey: string, orgId: string): Promise<ImageModelsResponse>;

package/dist/image.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
 exports.generateImage = generateImage;
 exports.getImageJob = getImageJob;
 exports.listImages = listImages;
 exports.deleteImage = deleteImage;
+exports.listModels = listModels;
 const client_1 = require("./client");
 const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /image/orgs/{org_id}/generate',
+    'GET /image/orgs/{org_id}/jobs/{job_id}',
+    'GET /image/orgs/{org_id}/list',
+    'GET /image/orgs/{org_id}/models',
+    'DELETE /image/orgs/{org_id}/images/{image_id}',
+];
 async function generateImage(apiKey, orgId, payload) {
     return (0, client_1.request)('POST', `${config_1.IMAGE_BASE}/image/orgs/${encodeURIComponent(orgId)}/generate`, apiKey, payload);
 }
@@ -18,3 +27,6 @@ async function listImages(apiKey, orgId) {
 async function deleteImage(apiKey, orgId, jobId) {
     return (0, client_1.request)('DELETE', `${config_1.IMAGE_BASE}/image/orgs/${encodeURIComponent(orgId)}/images/${encodeURIComponent(jobId)}`, apiKey);
 }
+async function listModels(apiKey, orgId) {
+    return (0, client_1.request)('GET', `${config_1.IMAGE_BASE}/image/orgs/${encodeURIComponent(orgId)}/models`, apiKey);
+}

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 export * from './types';
 export * from './client';
-export * from './config';
 export * as hq from './hq';
 export * as domain from './domain';
 export * as email from './email';
@@ -11,3 +10,9 @@ export * as storage from './storage';
 export * as webhook from './webhook';
 export * as workflow from './workflow';
 export * as url from './url';
+export * as people from './people';
+export * as company from './company';
+export * as audience from './audience';
+export * as llm from './llm';
+export * as database from './database';
+export * as crm from './crm';

package/dist/index.js

@@ -36,10 +36,15 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.url = exports.workflow = exports.webhook = exports.storage = exports.pixel = exports.image = exports.funnel = exports.email = exports.domain = exports.hq = void 0;
+exports.crm = exports.database = exports.llm = exports.audience = exports.company = exports.people = exports.url = exports.workflow = exports.webhook = exports.storage = exports.pixel = exports.image = exports.funnel = exports.email = exports.domain = exports.hq = void 0;
 __exportStar(require("./types"), exports);
 __exportStar(require("./client"), exports);
-__exportStar(require("./config"), exports);
+// Note: config constants (STORAGE_BASE etc.) are NOT re-exported from the
+// barrel. TypeScript compiles `export * from './config'` to a runtime
+// `__exportStar` call that Node's cjs-module-lexer can't see through, so
+// downstream ESM consumers fail with "Named export not found" against the
+// CJS-compiled SDK. If you need a base URL in a downstream package, mirror
+// the constant locally — it's one line and the comment makes it obvious.
 exports.hq = __importStar(require("./hq"));
 exports.domain = __importStar(require("./domain"));
 exports.email = __importStar(require("./email"));
@@ -50,3 +55,9 @@ exports.storage = __importStar(require("./storage"));
 exports.webhook = __importStar(require("./webhook"));
 exports.workflow = __importStar(require("./workflow"));
 exports.url = __importStar(require("./url"));
+exports.people = __importStar(require("./people"));
+exports.company = __importStar(require("./company"));
+exports.audience = __importStar(require("./audience"));
+exports.llm = __importStar(require("./llm"));
+exports.database = __importStar(require("./database"));
+exports.crm = __importStar(require("./crm"));

package/dist/llm.d.ts

@@ -0,0 +1,50 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
+export type Role = 'system' | 'user' | 'assistant';
+export interface Message {
+    role: Role;
+    content: string;
+}
+export interface CompleteRequest {
+    model: string;
+    messages: Message[];
+    max_tokens?: number;
+    temperature?: number;
+    stop?: string[];
+}
+export interface CompleteResponse {
+    model: string;
+    content: string;
+    finish_reason: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    };
+}
+export interface EmbedRequest {
+    model: string;
+    input: string | string[];
+}
+export interface EmbedResponse {
+    model: string;
+    embeddings: number[][];
+    usage: {
+        input_tokens: number;
+        cost_usd: number;
+    };
+}
+export interface Model {
+    id: string;
+    kind: 'chat' | 'embed';
+    context?: number;
+    dimensions?: number;
+    input_per_1m: number;
+    output_per_1m?: number;
+}
+export interface ModelsResponse {
+    models: Model[];
+}
+export declare function complete(apiKey: string, orgId: string, req: CompleteRequest): Promise<CompleteResponse>;
+export declare function embed(apiKey: string, orgId: string, req: EmbedRequest): Promise<EmbedResponse>;
+export declare function listModels(apiKey: string, orgId: string): Promise<ModelsResponse>;

package/dist/llm.js

@@ -0,0 +1,27 @@
+"use strict";
+// Scaffolded from schema by scripts/scaffold-sdk.js — DO NOT remove the
+// EXPOSES array (the coverage tool verifies it against the live schema).
+// Types and function names ARE editable; re-running the scaffolder against
+// a service whose config has been changed will diff vs. existing file
+// (use --dry-run to inspect).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
+exports.complete = complete;
+exports.embed = embed;
+exports.listModels = listModels;
+const client_1 = require("./client");
+const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /llm/orgs/{org_id}/complete',
+    'POST /llm/orgs/{org_id}/embed',
+    'GET /llm/orgs/{org_id}/models',
+];
+async function complete(apiKey, orgId, req) {
+    return (0, client_1.request)('POST', `${config_1.LLM_BASE}/llm/orgs/${encodeURIComponent(orgId)}/complete`, apiKey, req);
+}
+async function embed(apiKey, orgId, req) {
+    return (0, client_1.request)('POST', `${config_1.LLM_BASE}/llm/orgs/${encodeURIComponent(orgId)}/embed`, apiKey, req);
+}
+async function listModels(apiKey, orgId) {
+    return (0, client_1.request)('GET', `${config_1.LLM_BASE}/llm/orgs/${encodeURIComponent(orgId)}/models`, apiKey);
+}

package/dist/people.d.ts

@@ -0,0 +1,54 @@
+import type { Exposes } from './exposes';
+import type { SearchFilter } from './audience';
+export declare const EXPOSES: Exposes;
+export interface Location {
+    city?: string;
+    region?: string;
+    country?: string;
+}
+export interface Person {
+    id: string;
+    full_name: string;
+    first_name?: string;
+    last_name?: string;
+    email?: string;
+    email_type?: string;
+    link_confidence?: number;
+    location: Location;
+    company_id: string;
+    company: PersonCompany;
+}
+export interface PersonCompany {
+    id: string;
+    domain?: string;
+    name: string;
+    general_phone?: string;
+    address?: string;
+    is_registered_entity: boolean;
+    confidence: 'high' | 'low' | 'very_low';
+    country?: string;
+    country_consistent: boolean;
+    tld_class?: string;
+    has_careers_page: boolean;
+    has_investors_page: boolean;
+    has_shop_page: boolean;
+    has_blog: boolean;
+    has_c_level: boolean;
+    has_decision_maker: boolean;
+    headcount_lower_bound: number;
+    org_breadth: number;
+    source_count: number;
+    subdomain_variety: number;
+    multilingual: boolean;
+    language_count: number;
+    location?: Location;
+}
+export interface PeopleSearchResult {
+    people: Person[];
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+export declare function searchPeople(apiKey: string, orgId: string, filter: SearchFilter): Promise<PeopleSearchResult>;
+export declare function getPerson(apiKey: string, orgId: string, personId: string): Promise<Person>;

package/dist/people.js

@@ -0,0 +1,22 @@
+"use strict";
+// Scaffolded from schema by scripts/scaffold-sdk.js — DO NOT remove the
+// EXPOSES array (the coverage tool verifies it against the live schema).
+// Types and function names ARE editable; re-running the scaffolder against
+// a service whose config has been changed will diff vs. existing file
+// (use --dry-run to inspect).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
+exports.searchPeople = searchPeople;
+exports.getPerson = getPerson;
+const client_1 = require("./client");
+const config_1 = require("./config");
+exports.EXPOSES = [
+    'POST /people/orgs/{org_id}/search',
+    'GET /people/orgs/{org_id}/{person_id}',
+];
+async function searchPeople(apiKey, orgId, filter) {
+    return (0, client_1.request)('POST', `${config_1.PEOPLE_BASE}/people/orgs/${encodeURIComponent(orgId)}/search`, apiKey, filter);
+}
+async function getPerson(apiKey, orgId, personId) {
+    return (0, client_1.request)('GET', `${config_1.PEOPLE_BASE}/people/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(personId)}`, apiKey);
+}

package/dist/pixel.d.ts

@@ -1,3 +1,5 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
 export interface InteractionsResponse {
     interactions: (Visit | PixelEvent)[];
     total_visits: number;
@@ -63,3 +65,4 @@ export declare function getIdentity(apiKey: string, orgId: string, pixelId: stri
     }>;
     latency_ms: number;
 }>;
+export declare function getGeoSample(apiKey: string, orgId: string): Promise<Record<string, unknown>>;

package/dist/pixel.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
 exports.getInteractions = getInteractions;
 exports.getVisits = getVisits;
 exports.getEvents = getEvents;
 exports.getIdentity = getIdentity;
+exports.getGeoSample = getGeoSample;
 const client_1 = require("./client");
 const config_1 = require("./config");
+exports.EXPOSES = [
+    'GET /pixel/orgs/{org_id}/interactions',
+    'GET /pixel/orgs/{org_id}/visits',
+    'GET /pixel/orgs/{org_id}/events',
+    'GET /pixel/orgs/{org_id}/identity/{pixel_id}',
+    'GET /pixel/orgs/{org_id}/audience/get_geo_sample',
+];
 async function getInteractions(apiKey, orgId, params) {
     const qs = new URLSearchParams();
     for (const [key, val] of Object.entries(params)) {
@@ -42,3 +51,9 @@ async function getEvents(apiKey, orgId, params) {
 async function getIdentity(apiKey, orgId, pixelId) {
     return (0, client_1.request)('GET', `${config_1.PIXEL_BASE}/pixel/orgs/${encodeURIComponent(orgId)}/identity/${encodeURIComponent(pixelId)}`, apiKey);
 }
+// Sample of geographic distribution of the org's pixel audience. Backend
+// returns whatever shape it wants; we type as record-of-unknowns and let
+// callers print or destructure as needed.
+async function getGeoSample(apiKey, orgId) {
+    return (0, client_1.request)('GET', `${config_1.PIXEL_BASE}/pixel/orgs/${encodeURIComponent(orgId)}/audience/get_geo_sample`, apiKey);
+}

package/dist/services.d.ts

@@ -0,0 +1,17 @@
+export type ServiceStatus = 'ga' | 'preview' | 'planned';
+export type ServiceCategory = 'send' | 'capture' | 'data' | 'store' | 'compute' | 'identity' | 'infra';
+export interface ServiceMeta {
+    /** SDK namespace (also OpenAPI tag and CLI top-level command). */
+    module: string;
+    /** Skill name — used for: GitHub repo name, npm package name, plugin.json `name`, README headings. */
+    skill: string;
+    /** Brand domain we own (or want to own). Used for canonical links + npm/GitHub homepage. */
+    domain: string;
+    /** One-line description — used verbatim in npm description, GitHub repo description, plugin.json. */
+    description: string;
+    category: ServiceCategory;
+    status: ServiceStatus;
+    /** npm keywords + GitHub topics + PyPI classifiers. The first five are shared boilerplate. */
+    keywords: string[];
+}
+export declare const SERVICES: readonly ServiceMeta[];