@myapihq/sdk 1.0.0

package/src/hq.ts

@@ -0,0 +1,109 @@
+import { request } from './client';
+
+const BASE_URL = 'https://api.myapihq.com';
+
+export interface Org {
+  id: string;
+  name: string;
+  tagline?: string;
+  description?: string;
+  business_sector?: string;
+  logo_url?: string;
+  favicon_url?: string;
+  og_image_url?: string;
+  color_palette?: Record<string, string>;
+  font_family?: string;
+  imagery_style?: string;
+  headline?: string;
+  subheadline?: string;
+  cta_text?: string;
+  value_propositions?: string[];
+  social_links?: Record<string, string>;
+  canonical_url?: string;
+  privacy_policy_url?: string;
+  cookie_policy_url?: string;
+  terms_url?: string;
+  gdpr_enabled?: boolean;
+  default_language?: string;
+  tracking?: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export type OrgPayload = Omit<Org, 'id' | 'created_at' | 'updated_at'>;
+
+export async function createAgentAccount(): Promise<{ account_id: string; pin: string; token: string }> {
+  return request('POST', `${BASE_URL}/hq/account/agent/create`);
+}
+
+export async function recoverAgentToken(pin: string): Promise<{ token: string }> {
+  return request('POST', `${BASE_URL}/hq/account/agent/token`, undefined, { pin });
+}
+
+export async function createApiKey(jwtToken: string, name: string): Promise<{ api_key: string; id: string; prefix: string }> {
+  return request('POST', `${BASE_URL}/hq/account/create/key`, jwtToken, { name });
+}
+
+export async function listApiKeys(apiKey: string): Promise<{ id: string; name: string; prefix: string; created_at: string }[]> {
+  return request('GET', `${BASE_URL}/hq/account/keys`, apiKey);
+}
+
+export async function revokeApiKey(apiKey: string, keyId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/hq/account/delete/key/${encodeURIComponent(keyId)}`, apiKey);
+}
+
+export async function linkAgent(apiKey: string, pin: string): Promise<void> {
+  return request('POST', `${BASE_URL}/hq/account/link-agent`, apiKey, { pin });
+}
+
+export async function listLinkedAgents(apiKey: string): Promise<{ account_id: string; created_at: string }[]> {
+  return request('GET', `${BASE_URL}/hq/account/agents`, apiKey);
+}
+
+export async function createOrg(apiKey: string, payload: OrgPayload): Promise<Org> {
+  return request('POST', `${BASE_URL}/hq/orgs`, apiKey, payload);
+}
+
+export async function importOrg(apiKey: string, domain: string, autoAccept?: boolean): Promise<{ job_id: string; status: string }> {
+  return request('POST', `${BASE_URL}/hq/org-imports`, apiKey, { domain, auto_accept: autoAccept });
+}
+
+export async function getOrgImportStatus(apiKey: string, jobId: string): Promise<{ status: string; brand_preview: unknown }> {
+  return request('GET', `${BASE_URL}/hq/org-imports/${encodeURIComponent(jobId)}`, apiKey);
+}
+
+export async function confirmOrgImport(apiKey: string, jobId: string, overrides?: Partial<OrgPayload>): Promise<Org> {
+  return request('POST', `${BASE_URL}/hq/org-imports/${encodeURIComponent(jobId)}/confirm`, apiKey, overrides);
+}
+
+export async function listOrgs(apiKey: string): Promise<Org[]> {
+  return request('GET', `${BASE_URL}/hq/orgs`, apiKey);
+}
+
+export async function getOrg(apiKey: string, orgId: string): Promise<Org> {
+  return request('GET', `${BASE_URL}/hq/orgs/${encodeURIComponent(orgId)}`, apiKey);
+}
+
+export async function updateOrg(apiKey: string, orgId: string, payload: Partial<OrgPayload>): Promise<Org> {
+  return request('PATCH', `${BASE_URL}/hq/orgs/${encodeURIComponent(orgId)}`, apiKey, payload);
+}
+
+export async function deleteOrg(apiKey: string, orgId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/hq/orgs/${encodeURIComponent(orgId)}`, apiKey);
+}
+
+export async function getBalance(apiKey: string): Promise<{ balance_cents: number; balance_display: string; has_payment_method: boolean }> {
+  return request('GET', `${BASE_URL}/hq/billing/balance`, apiKey);
+}
+
+export async function getBillingHistory(apiKey: string): Promise<{ amount_cents: number; status: string; created_at: string }[]> {
+  return request('GET', `${BASE_URL}/hq/billing/history`, apiKey);
+}
+
+export async function setupPayment(apiKey: string): Promise<{ url: string }> {
+  return request('POST', `${BASE_URL}/hq/billing/setup-payment`, apiKey);
+}
+
+export async function topUp(apiKey: string, amountCents: number): Promise<{ new_balance_cents: number; new_balance_display: string }> {
+  return request('POST', `${BASE_URL}/hq/billing/topup`, apiKey, { amount_cents: amountCents });
+}

package/src/image.ts

@@ -0,0 +1,31 @@
+import { request } from './client';
+
+const BASE_URL = 'https://api.myimageapi.com';
+
+export interface ImageJob {
+  job_id: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+  url?: string;
+  error?: string;
+  prompt: string;
+  aspect_ratio: string;
+  created_at: string;
+}
+
+export async function generateImage(apiKey: string, payload: {
+  prompt: string;
+  aspect_ratio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4';
+  style?: string;
+  colors?: string;
+  has_text?: boolean;
+}): Promise<{ job_id: string; status: string }> {
+  return request('POST', `${BASE_URL}/image/generate`, apiKey, payload);
+}
+
+export async function getImageJob(apiKey: string, jobId: string): Promise<ImageJob> {
+  return request('GET', `${BASE_URL}/image/jobs/${encodeURIComponent(jobId)}`, apiKey);
+}
+
+export async function listImages(apiKey: string): Promise<ImageJob[]> {
+  return request('GET', `${BASE_URL}/image/list`, apiKey);
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export * from './client';
+export * as hq from './hq';
+export * as domain from './domain';
+export * as email from './email';
+export * as funnel from './funnel';
+export * as image from './image';
+export * as pixel from './pixel';
+export * as storage from './storage';
+export * as webhook from './webhook';
+export * as workflow from './workflow';

package/src/pixel.ts

@@ -0,0 +1,61 @@
+import { request } from './client';
+
+const BASE_URL = 'https://api.mypixelapi.com';
+
+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, 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/interactions${queryString ? `?${queryString}` : ''}`;
+  return request('GET', url, apiKey);
+}
+
+export async function getVisits(apiKey: 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/visits${queryString ? `?${queryString}` : ''}`;
+  return request('GET', url, apiKey);
+}
+
+export async function getEvents(apiKey: 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/events${queryString ? `?${queryString}` : ''}`;
+  return request('GET', url, apiKey);
+}
+
+export async function getIdentity(apiKey: string, pixelId: string): Promise<{ uuid: string; is_resolved: boolean; nodes: Record<string, { type: string; probability: number }>; latency_ms: number }> {
+  return request('GET', `${BASE_URL}/pixel/identity/${encodeURIComponent(pixelId)}`, apiKey);
+}

package/src/storage.ts

@@ -0,0 +1,55 @@
+import { request, MyApiError } from './client';
+import { ApiResponse } from './types';
+
+const BASE_URL = 'https://api.mystorageapi.com';
+
+export interface Asset { asset_id: string; url: string; name: string; created_at: string }
+
+export async function ingestAsset(apiKey: string, url: string, name?: string): Promise<Asset> {
+  return request('POST', `${BASE_URL}/hq/assets/ingest`, apiKey, { url, name });
+}
+
+export async function uploadAsset(apiKey: string, file: Blob | Buffer, contentType: 'image/jpeg' | 'image/png', name?: string): Promise<Asset> {
+  const headers: Record<string, string> = {
+    'Authorization': `Bearer ${apiKey}`
+  };
+  
+  const formData = new FormData();
+  formData.append('file', new Blob([file as any], { type: contentType }));
+  if (name) {
+    formData.append('name', name);
+  }
+
+  const response = await fetch(`${BASE_URL}/hq/assets/upload`, {
+    method: 'POST',
+    headers,
+    body: formData as any
+  });
+  
+  let result: any;
+  try {
+    result = await response.json();
+  } catch {
+    throw new MyApiError('invalid_json_response', response.status);
+  }
+
+  if (!response.ok) {
+    const code = result?.error || 'unknown_error';
+    throw new MyApiError(code, response.status);
+  }
+
+  const apiResponse = result as ApiResponse<Asset>;
+  if (!apiResponse.success) {
+    throw new MyApiError(apiResponse.error || 'unknown_error', response.status);
+  }
+
+  return apiResponse.data as Asset;
+}
+
+export async function listAssets(apiKey: string): Promise<Asset[]> {
+  return request('GET', `${BASE_URL}/hq/assets`, apiKey);
+}
+
+export async function deleteAsset(apiKey: string, assetId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/hq/assets/${encodeURIComponent(assetId)}`, apiKey);
+}

package/src/types.ts

@@ -0,0 +1,13 @@
+export interface ApiResponse<T> {
+  success: boolean;
+  data: T | null;
+  error: string | null;
+  meta: { request_id: string; latency_ms: number; service: string; version: string };
+}
+
+export interface PaginatedResponse<T> {
+  data: T[];
+  total: number;
+  limit: number;
+  offset: number;
+}

package/src/webhook.ts

@@ -0,0 +1,22 @@
+import { request } from './client';
+
+const BASE_URL = 'https://api.mywebhookapi.com';
+
+export interface WebhookEndpoint { id: string; org_id: string; name: string; slug: string; inbound_url: string; created_at: string }
+export interface Delivery { id: string; endpoint_id: string; payload: unknown; headers: Record<string, string>; status: string; created_at: string }
+
+export async function createEndpoint(apiKey: string, orgId: string, name: string, description?: string): Promise<WebhookEndpoint> {
+  return request('POST', `${BASE_URL}/webhook/endpoints`, apiKey, { org_id: orgId, name, description });
+}
+
+export async function listEndpoints(apiKey: string): Promise<WebhookEndpoint[]> {
+  return request('GET', `${BASE_URL}/webhook/endpoints`, apiKey);
+}
+
+export async function deleteEndpoint(apiKey: string, endpointId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/webhook/endpoints/${encodeURIComponent(endpointId)}`, apiKey);
+}
+
+export async function getDelivery(apiKey: string, deliveryId: string): Promise<Delivery> {
+  return request('GET', `${BASE_URL}/webhook/deliveries/${encodeURIComponent(deliveryId)}`, apiKey);
+}

package/src/workflow.ts

@@ -0,0 +1,51 @@
+import { request } from './client';
+
+const BASE_URL = 'https://api.myworkflowapi.com';
+
+export type WorkflowStep =
+  | { type: 'send_email'; from: string; to: string; subject: string; template_id?: string; html?: string }
+  | { type: 'slack_message'; webhook_url: string; text: string };
+
+export interface Workflow { id: string; org_id: string; name: string; status: 'enabled' | 'disabled'; trigger_config: { endpoint_id: string }; steps: WorkflowStep[]; created_at: string }
+export interface WorkflowRun { id: string; workflow_id: string; trigger_payload: unknown; status: 'pending' | 'running' | 'completed' | 'failed'; error?: string; attempt: number; started_at: string; finished_at?: string; created_at: string }
+
+export async function createWorkflow(apiKey: string, payload: {
+  org_id: string;
+  name: string;
+  trigger_config: { endpoint_id: string };
+  steps: WorkflowStep[];
+}): Promise<Workflow> {
+  return request('POST', `${BASE_URL}/workflow/workflows`, apiKey, payload);
+}
+
+export async function listWorkflows(apiKey: string): Promise<Workflow[]> {
+  return request('GET', `${BASE_URL}/workflow/workflows`, apiKey);
+}
+
+export async function getWorkflow(apiKey: string, workflowId: string): Promise<Workflow> {
+  return request('GET', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}`, apiKey);
+}
+
+export async function updateWorkflow(apiKey: string, workflowId: string, payload: { name?: string; trigger_config?: { endpoint_id: string }; steps?: WorkflowStep[] }): Promise<Workflow> {
+  return request('PATCH', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}`, apiKey, payload);
+}
+
+export async function enableWorkflow(apiKey: string, workflowId: string): Promise<void> {
+  return request('POST', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}/enable`, apiKey);
+}
+
+export async function disableWorkflow(apiKey: string, workflowId: string): Promise<void> {
+  return request('POST', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}/disable`, apiKey);
+}
+
+export async function deleteWorkflow(apiKey: string, workflowId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}`, apiKey);
+}
+
+export async function listWorkflowRuns(apiKey: string, workflowId: string): Promise<WorkflowRun[]> {
+  return request('GET', `${BASE_URL}/workflow/workflows/${encodeURIComponent(workflowId)}/runs`, apiKey);
+}
+
+export async function getWorkflowRun(apiKey: string, runId: string): Promise<WorkflowRun> {
+  return request('GET', `${BASE_URL}/workflow/runs/${encodeURIComponent(runId)}`, apiKey);
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}