@myapihq/sdk 2.4.1 → 2.4.2

package/src/payments.ts

@@ -1,98 +0,0 @@
-import { request } from './client';
-import { PAYMENTS_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-// Backend: my-payments-api T0 (BYO Stripe) per
-// myapi-hq/internal/routes/payments/. T1 (Connect Express) is deferred —
-// connect with tier 't1' returns 501. The webhook receiver is public
-// (Stripe signs it); it is listed here for parity but has no SDK function.
-export const EXPOSES: Exposes = [
-  'POST /payments/orgs/{org_id}/connect',
-  'GET /payments/orgs/{org_id}/connect',
-  'POST /payments/orgs/{org_id}/charges',
-  'GET /payments/orgs/{org_id}/charges',
-  'GET /payments/orgs/{org_id}/charges/{id}',
-  'POST /payments/orgs/{org_id}/charges/{id}/refund',
-  'POST /payments/webhook/{org_id}',
-];
-
-// Connection status — the org's Stripe link. T0 takes no platform fee, so
-// `application_fee_bps` is 0.
-export interface ConnectStatus {
-  connected?: boolean;
-  tier: string;
-  stripe_account_id: string;
-  onboarding_status: string;
-  application_fee_bps?: number;
-}
-
-// Charge billing interval. Absent = a one-off payment.
-export type ChargeInterval = 'month' | 'year';
-
-// A charge — mirrors the backend's `chargeView`.
-export interface Charge {
-  id: string;
-  amount_cents: number;
-  currency: string;
-  every?: ChargeInterval;
-  description?: string;
-  customer_email?: string;
-  status: string;
-  created_at: string;
-  succeeded_at?: string;
-  refunded_at?: string;
-}
-
-// CreateCharge returns a hosted Stripe Checkout URL the agent pastes into
-// its frontend — not a completed payment.
-export interface CreateChargeResponse {
-  payment_id: string;
-  checkout_url: string;
-  status: string;
-}
-
-export interface CreateChargePayload {
-  amount_cents: number;                // required, > 0
-  currency?: string;                   // defaults to 'usd' server-side
-  email?: string;                      // pre-fills the Checkout customer
-  description?: string;                // shows on the Checkout line item
-  every?: ChargeInterval;              // present = a subscription
-  success_url?: string;
-  cancel_url?: string;
-}
-
-// connect links the org's own Stripe account (T0 — BYO secret key). The
-// key is validated live against Stripe and stored encrypted; it never
-// touches MyAPI Postgres or a log line. Pass a 't1' tier to see the
-// 501 T1_DEFERRED path.
-export async function connect(apiKey: string, orgId: string, stripeSecretKey: string, tier: 't0' | 't1' = 't0'): Promise<ConnectStatus> {
-  return request('POST', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/connect`, apiKey, {
-    tier,
-    stripe_secret_key: stripeSecretKey,
-  });
-}
-
-// getConnect reads the org's connection status. Returns { connected: false } when no Stripe is linked (no longer a 404).
-// when the org has not connected Stripe.
-export async function getConnect(apiKey: string, orgId: string): Promise<ConnectStatus> {
-  return request('GET', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/connect`, apiKey);
-}
-
-// createCharge opens a Stripe Checkout Session on the org's connected
-// account. `every` makes it a subscription; otherwise a one-off payment.
-export async function createCharge(apiKey: string, orgId: string, payload: CreateChargePayload): Promise<CreateChargeResponse> {
-  return request('POST', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/charges`, apiKey, payload);
-}
-
-export async function listCharges(apiKey: string, orgId: string): Promise<Charge[]> {
-  return request('GET', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/charges`, apiKey);
-}
-
-export async function getCharge(apiKey: string, orgId: string, chargeId: string): Promise<Charge> {
-  return request('GET', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/charges/${encodeURIComponent(chargeId)}`, apiKey);
-}
-
-// refundCharge issues a full refund (v1 — partial refunds out of scope).
-export async function refundCharge(apiKey: string, orgId: string, chargeId: string): Promise<{ id: string; status: string }> {
-  return request('POST', `${BASE_URL}/payments/orgs/${encodeURIComponent(orgId)}/charges/${encodeURIComponent(chargeId)}/refund`, apiKey);
-}

package/src/people.ts

@@ -1,84 +0,0 @@
-// 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).
-
-import { request } from './client';
-import { PEOPLE_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-import type { SearchFilter } from './audience';
-
-export const EXPOSES: Exposes = [
-  'POST /people/orgs/{org_id}/search',
-  'GET /people/orgs/{org_id}/{person_id}',
-];
-
-export interface Location {
-  city?: string;
-  region?: string;
-  country?: string; // ISO 3166-1 alpha-2
-}
-
-// Goldfox-sourced person row. The data model is crawl-derived signals over
-// scraped contact pages; rich on quality tiers and behavioral booleans,
-// thin on legacy CRM fields (no title / function / industry as response
-// columns — many of those moved to filterable inputs only).
-export interface Person {
-  id: string;
-  full_name: string;
-  first_name?: string;
-  last_name?: string;
-  email?: string;
-  email_type?: string;  // corporate | freemail | role_based | other_corporate
-  link_confidence?: number; // 0..1 — 1.0 = email-domain match (definitive)
-  location: Location;
-  company_id: string;
-  company: PersonCompany;
-}
-
-// Person.company embeds the same shape returned by /company/search results.
-// PersonCompany is an alias for Company — the company sub-object on a person
-// row is identical to a standalone company row.
-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; // cctld | generic | vanity | low_trust | other
-  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 async function searchPeople(apiKey: string, orgId: string, filter: SearchFilter): Promise<PeopleSearchResult> {
-  return request('POST', `${BASE_URL}/people/orgs/${encodeURIComponent(orgId)}/search`, apiKey, filter);
-}
-
-export async function getPerson(apiKey: string, orgId: string, personId: string): Promise<Person> {
-  return request('GET', `${BASE_URL}/people/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(personId)}`, apiKey);
-}

package/src/pixel.ts

@@ -1,80 +0,0 @@
-import { request } from './client';
-import { PIXEL_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-export const EXPOSES: 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',
-];
-
-
-
-export interface InteractionsResponse {
-  interactions: (Visit | PixelEvent)[];
-  total_visits: number;
-  total_events: number;
-  limit: number;
-  offset: number;
-}
-export interface Visit { type: 'visit'; pixel_id: string; from_url: string; to_url: string; ts: string }
-export interface PixelEvent { type: 'event'; pixel_id: string; event_type: 'sent' | 'open' | 'click' | 'page_visit'; url?: string; campaign_id?: string; ts: string }
-
-export async function getInteractions(apiKey: string, orgId: string, params: {
-  website?: string;
-  domain?: string;
-  campaign_id?: string;
-  from?: string;
-  to?: string;
-  limit?: number;
-  offset?: number;
-}): Promise<InteractionsResponse> {
-  const qs = new URLSearchParams();
-  for (const [key, val] of Object.entries(params)) {
-    if (val !== undefined && val !== null) {
-      qs.set(key, String(val));
-    }
-  }
-  const queryString = qs.toString();
-  const url = `${BASE_URL}/pixel/orgs/${encodeURIComponent(orgId)}/interactions${queryString ? `?${queryString}` : ''}`;
-  return request('GET', url, apiKey);
-}
-
-export async function getVisits(apiKey: string, orgId: string, params: { website: string; from?: string; to?: string; limit?: number; offset?: number }): Promise<{ visits: Visit[]; total: number; limit: number; offset: number }> {
-  const qs = new URLSearchParams();
-  for (const [key, val] of Object.entries(params)) {
-    if (val !== undefined && val !== null) {
-      qs.set(key, String(val));
-    }
-  }
-  const queryString = qs.toString();
-  const url = `${BASE_URL}/pixel/orgs/${encodeURIComponent(orgId)}/visits${queryString ? `?${queryString}` : ''}`;
-  return request('GET', url, apiKey);
-}
-
-export async function getEvents(apiKey: string, orgId: string, params: { campaign_id?: string; domain?: string; from?: string; to?: string; limit?: number; offset?: number }): Promise<{ events: PixelEvent[]; total: number; limit: number; offset: number }> {
-  const qs = new URLSearchParams();
-  for (const [key, val] of Object.entries(params)) {
-    if (val !== undefined && val !== null) {
-      qs.set(key, String(val));
-    }
-  }
-  const queryString = qs.toString();
-  const url = `${BASE_URL}/pixel/orgs/${encodeURIComponent(orgId)}/events${queryString ? `?${queryString}` : ''}`;
-  return request('GET', url, apiKey);
-}
-
-// getIdentity resolves a pixel's identity graph. `website` is required —
-// the backend scopes the lookup to a domain the org owns.
-export async function getIdentity(apiKey: string, orgId: string, pixelId: string, website: string): Promise<{ uuid: string; is_resolved: boolean; nodes: Record<string, { type: string; probability: number }>; latency_ms: number }> {
-  return request('GET', `${BASE_URL}/pixel/orgs/${encodeURIComponent(orgId)}/identity/${encodeURIComponent(pixelId)}?website=${encodeURIComponent(website)}`, 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.
-export async function getGeoSample(apiKey: string, orgId: string): Promise<Record<string, unknown>> {
-  return request('GET', `${BASE_URL}/pixel/orgs/${encodeURIComponent(orgId)}/audience/get_geo_sample`, apiKey);
-}

package/src/queue.ts

@@ -1,115 +0,0 @@
-import { request } from './client';
-import { QUEUE_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-// Backend: my-queue-api per myapi-hq/internal/routes/queue/. A durable
-// HTTP-consumer job queue — each named queue POSTs its jobs to a configured
-// consumer_url, with retry/backoff to max_attempts, a concurrency cap, and a
-// dependency DAG (a job with unsucceeded depends_on starts blocked).
-export const EXPOSES: Exposes = [
-  'POST /queue/orgs/{org_id}/queues',
-  'GET /queue/orgs/{org_id}/queues',
-  'GET /queue/orgs/{org_id}/queues/{name}',
-  'DELETE /queue/orgs/{org_id}/queues/{name}',
-  'POST /queue/orgs/{org_id}/queues/{name}/jobs',
-  'GET /queue/orgs/{org_id}/queues/{name}/jobs',
-  'GET /queue/orgs/{org_id}/jobs/{id}',
-];
-
-export interface Queue {
-  id: string;
-  org_id: string;
-  name: string;
-  consumer_url: string;
-  max_attempts: number;
-  max_concurrency: number;
-  created_at: string;
-}
-
-// A job that exhausts max_attempts goes straight to `dead` — there is no
-// separate `failed` state.
-export type JobStatus = 'pending' | 'blocked' | 'running' | 'succeeded' | 'dead';
-
-export interface Job {
-  id: string;
-  queue_id: string;
-  org_id: string;
-  payload: unknown;
-  status: JobStatus;
-  attempt: number;
-  max_attempts: number;
-  not_before: string;
-  depends_on: string[];
-  dedup_key?: string;
-  last_error?: string;
-  started_at?: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface CreateQueueOptions {
-  name: string;
-  consumerUrl: string;
-  maxAttempts?: number;
-  maxConcurrency?: number;
-}
-
-export interface EnqueueOptions {
-  payload?: unknown;
-  dedupKey?: string;
-  delaySeconds?: number;
-  // Job ids this job waits on. Immutable — the DAG is declared at enqueue.
-  // Same shape as task.create's depends_on.
-  dependsOn?: string[];
-}
-
-function queuesBase(orgId: string): string {
-  return `${BASE_URL}/queue/orgs/${encodeURIComponent(orgId)}/queues`;
-}
-
-// createQueue registers a named queue with its retry + concurrency policy
-// and the HTTP consumer that runs its jobs.
-export async function createQueue(apiKey: string, orgId: string, opts: CreateQueueOptions): Promise<Queue> {
-  const body: Record<string, unknown> = { name: opts.name, consumer_url: opts.consumerUrl };
-  if (opts.maxAttempts !== undefined) body.max_attempts = opts.maxAttempts;
-  if (opts.maxConcurrency !== undefined) body.max_concurrency = opts.maxConcurrency;
-  return request('POST', queuesBase(orgId), apiKey, body);
-}
-
-export async function listQueues(apiKey: string, orgId: string): Promise<Queue[]> {
-  const res = await request<{ queues?: Queue[] }>('GET', queuesBase(orgId), apiKey);
-  return res?.queues ?? [];
-}
-
-export async function getQueue(apiKey: string, orgId: string, name: string): Promise<Queue> {
-  return request('GET', `${queuesBase(orgId)}/${encodeURIComponent(name)}`, apiKey);
-}
-
-export async function deleteQueue(apiKey: string, orgId: string, name: string): Promise<void> {
-  return request('DELETE', `${queuesBase(orgId)}/${encodeURIComponent(name)}`, apiKey);
-}
-
-// enqueueJob is idempotent on (queue, dedup_key). A job with unsucceeded
-// depends_on starts blocked.
-export async function enqueueJob(apiKey: string, orgId: string, name: string, opts: EnqueueOptions = {}): Promise<Job> {
-  const body: Record<string, unknown> = {};
-  if (opts.payload !== undefined) body.payload = opts.payload;
-  if (opts.dedupKey !== undefined) body.dedup_key = opts.dedupKey;
-  if (opts.delaySeconds !== undefined) body.delay_seconds = opts.delaySeconds;
-  if (opts.dependsOn !== undefined) body.depends_on = opts.dependsOn;
-  return request('POST', `${queuesBase(orgId)}/${encodeURIComponent(name)}/jobs`, apiKey, body);
-}
-
-// listJobs lists a queue's jobs, newest first. `limit` is 1-200.
-export async function listJobs(apiKey: string, orgId: string, name: string, opts: { status?: string; limit?: number } = {}): Promise<Job[]> {
-  const q = new URLSearchParams();
-  if (opts.status) q.set('status', opts.status);
-  if (opts.limit !== undefined) q.set('limit', String(opts.limit));
-  const qs = q.toString();
-  const res = await request<{ jobs?: Job[] }>('GET', `${queuesBase(orgId)}/${encodeURIComponent(name)}/jobs${qs ? `?${qs}` : ''}`, apiKey);
-  return res?.jobs ?? [];
-}
-
-export async function getJob(apiKey: string, orgId: string, jobId: string): Promise<Job> {
-  return request('GET', `${BASE_URL}/queue/orgs/${encodeURIComponent(orgId)}/jobs/${encodeURIComponent(jobId)}`, apiKey);
-}