@myapihq/sdk 1.2.1 → 1.2.4

package/dist/client.d.ts

@@ -2,6 +2,7 @@ export declare class MyApiError extends Error {
     code: string;
     status: number;
     detail?: string | undefined;
-    constructor(code: string, status: number, detail?: string | undefined);
+    body?: Record<string, unknown> | undefined;
+    constructor(code: string, status: number, detail?: string | undefined, body?: Record<string, unknown> | undefined);
 }
 export declare function request<T>(method: string, url: string, apiKey?: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;

package/dist/client.js

@@ -6,13 +6,18 @@ class MyApiError extends Error {
     code;
     status;
     detail;
-    constructor(code, status, detail) {
+    body;
+    // `body` is the full error object as returned by the backend — preserved so
+    // callers can read service-specific fields the SDK doesn't otherwise model
+    // (e.g. CF_API_ERROR carries `cf_message` / `cf_status`).
+    constructor(code, status, detail, body) {
         // Surface the detail in the message so console.error / err.message
         // shows useful info without callers having to look at err.detail.
         super(detail ? `${code} (${status}): ${detail}` : code);
         this.code = code;
         this.status = status;
         this.detail = detail;
+        this.body = body;
         this.name = 'MyApiError';
     }
 }
@@ -59,14 +64,16 @@ async function request(method, url, apiKey, body, extraHeaders) {
         const err = result?.error;
         const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
         const detail = typeof err === 'object' ? (err?.message || undefined) : undefined;
-        throw new MyApiError(code, response.status, detail);
+        const body = typeof err === 'object' ? err : undefined;
+        throw new MyApiError(code, response.status, detail, body);
     }
     const apiResponse = result;
     if (!apiResponse.success) {
         const err = apiResponse.error;
         const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
         const detail = typeof err === 'object' ? (err?.message || undefined) : undefined;
-        throw new MyApiError(code, response.status, detail);
+        const body = typeof err === 'object' ? err : undefined;
+        throw new MyApiError(code, response.status, detail, body);
     }
     return apiResponse.data;
 }

package/dist/domain.d.ts

@@ -6,6 +6,17 @@ export interface DomainRecord {
     expires_at?: string;
     days_until_expiry?: number;
     email_infra_ready?: boolean;
+    email_infra?: 'skipped' | 'pending' | 'ready' | 'error';
+    email_subdomain?: string;
+    dns_active?: boolean;
+    steps_completed?: string[];
+    error_detail?: {
+        failed_step: string;
+        message: string;
+        retryable: boolean;
+        attempt_count?: number;
+        last_attempt_at?: string;
+    };
     org_id?: string | null;
     created_at: string;
 }
@@ -59,6 +70,44 @@ export declare function getDomainStatus(apiKey: string, orgId: string, domain: s
 export declare function assignDomain(apiKey: string, orgId: string, domain: string): Promise<DomainRecord>;
 export declare function unassignDomain(apiKey: string, orgId: string, domain: string): Promise<DomainRecord>;
 export declare function getDomainSettings(apiKey: string, orgId: string, domain: string): Promise<DomainSettings>;
+export type DnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT';
+export interface DnsRecord {
+    id: string;
+    type: DnsRecordType;
+    name: string;
+    content: string;
+    ttl: number;
+    priority: number | null;
+    proxied: boolean | null;
+    created_on: string;
+    modified_on: string;
+}
+export interface DnsRecordInput {
+    type: DnsRecordType;
+    name: string;
+    content: string;
+    ttl?: number;
+    priority?: number;
+    proxied?: boolean;
+}
+export declare function listDnsRecords(apiKey: string, orgId: string, domain: string, type?: DnsRecordType): Promise<DnsRecord[]>;
+export declare function getDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string): Promise<DnsRecord>;
+export declare function createDnsRecord(apiKey: string, orgId: string, domain: string, input: DnsRecordInput): Promise<DnsRecord>;
+export declare function updateDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string, input: Partial<Omit<DnsRecordInput, 'type'>>): Promise<DnsRecord>;
+export declare function deleteDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string): Promise<void>;
+export interface EmailInfraResponse {
+    domain: string;
+    email_infra: 'pending' | 'ready' | 'error';
+    email_subdomain: string;
+    next_step?: string;
+}
+export declare function setupEmailInfra(apiKey: string, orgId: string, domain: string, subdomain?: string): Promise<EmailInfraResponse>;
+export interface RetryProvisioningResponse {
+    domain: string;
+    email_infra?: string;
+    next_step?: string;
+}
+export declare function retryProvisioning(apiKey: string, orgId: string, domain: string): Promise<RetryProvisioningResponse>;
 export declare function updateDomainSettings(apiKey: string, orgId: string, domain: string, payload: {
     security_level?: 'essentially_off' | 'medium' | 'high' | 'under_attack';
     browser_check?: 'on' | 'off';

package/dist/domain.js

@@ -10,6 +10,13 @@ exports.getDomainStatus = getDomainStatus;
 exports.assignDomain = assignDomain;
 exports.unassignDomain = unassignDomain;
 exports.getDomainSettings = getDomainSettings;
+exports.listDnsRecords = listDnsRecords;
+exports.getDnsRecord = getDnsRecord;
+exports.createDnsRecord = createDnsRecord;
+exports.updateDnsRecord = updateDnsRecord;
+exports.deleteDnsRecord = deleteDnsRecord;
+exports.setupEmailInfra = setupEmailInfra;
+exports.retryProvisioning = retryProvisioning;
 exports.updateDomainSettings = updateDomainSettings;
 const client_1 = require("./client");
 const config_1 = require("./config");
@@ -23,6 +30,13 @@ exports.EXPOSES = [
     'GET /domain/orgs/{org_id}/{domain}/settings',
     'POST /domain/orgs/{org_id}/{domain}/settings',
     'GET /domain/orgs/{org_id}/{domain}/status',
+    'GET /domain/orgs/{org_id}/{domain}/records',
+    'GET /domain/orgs/{org_id}/{domain}/records/{record_id}',
+    'POST /domain/orgs/{org_id}/{domain}/records',
+    'PATCH /domain/orgs/{org_id}/{domain}/records/{record_id}',
+    'DELETE /domain/orgs/{org_id}/{domain}/records/{record_id}',
+    'POST /domain/orgs/{org_id}/{domain}/email-infra',
+    'POST /domain/orgs/{org_id}/{domain}/retry-provisioning',
 ];
 async function checkDomain(apiKey, orgId, domain) {
     return (0, client_1.request)('GET', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/check/available/${encodeURIComponent(domain)}`, apiKey);
@@ -56,6 +70,29 @@ async function unassignDomain(apiKey, orgId, domain) {
 async function getDomainSettings(apiKey, orgId, domain) {
     return (0, client_1.request)('GET', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/settings`, apiKey);
 }
+async function listDnsRecords(apiKey, orgId, domain, type) {
+    const query = type ? `?type=${encodeURIComponent(type)}` : '';
+    return (0, client_1.request)('GET', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records${query}`, apiKey);
+}
+async function getDnsRecord(apiKey, orgId, domain, recordId) {
+    return (0, client_1.request)('GET', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey);
+}
+async function createDnsRecord(apiKey, orgId, domain, input) {
+    return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records`, apiKey, input);
+}
+async function updateDnsRecord(apiKey, orgId, domain, recordId, input) {
+    return (0, client_1.request)('PATCH', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey, input);
+}
+async function deleteDnsRecord(apiKey, orgId, domain, recordId) {
+    return (0, client_1.request)('DELETE', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey);
+}
+async function setupEmailInfra(apiKey, orgId, domain, subdomain) {
+    const body = subdomain ? { subdomain } : {};
+    return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/email-infra`, apiKey, body);
+}
+async function retryProvisioning(apiKey, orgId, domain) {
+    return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/retry-provisioning`, apiKey);
+}
 async function updateDomainSettings(apiKey, orgId, domain, payload) {
     return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/settings`, apiKey, payload);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/sdk",
   "license": "Apache-2.0",
-  "version": "1.2.1",
+  "version": "1.2.4",
   "description": "TypeScript SDK for the MyAPI ecosystem",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client.ts

@@ -1,7 +1,10 @@
 import { ApiResponse } from './types';
 
 export class MyApiError extends Error {
-  constructor(public code: string, public status: number, public detail?: string) {
+  // `body` is the full error object as returned by the backend — preserved so
+  // callers can read service-specific fields the SDK doesn't otherwise model
+  // (e.g. CF_API_ERROR carries `cf_message` / `cf_status`).
+  constructor(public code: string, public status: number, public detail?: string, public body?: Record<string, unknown>) {
     // Surface the detail in the message so console.error / err.message
     // shows useful info without callers having to look at err.detail.
     super(detail ? `${code} (${status}): ${detail}` : code);
@@ -69,7 +72,8 @@ export async function request<T>(
     const err = result?.error;
     const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
     const detail = typeof err === 'object' ? (err?.message || undefined) : undefined;
-    throw new MyApiError(code, response.status, detail);
+    const body = typeof err === 'object' ? err : undefined;
+    throw new MyApiError(code, response.status, detail, body);
   }
 
   const apiResponse = result as ApiResponse<T>;
@@ -77,7 +81,8 @@ export async function request<T>(
     const err = apiResponse.error as any;
     const code = typeof err === 'object' ? (err?.code || 'unknown_error') : (err || 'unknown_error');
     const detail = typeof err === 'object' ? (err?.message || undefined) : undefined;
-    throw new MyApiError(code, response.status, detail);
+    const body = typeof err === 'object' ? err : undefined;
+    throw new MyApiError(code, response.status, detail, body);
   }
 
   return apiResponse.data as T;

package/src/domain.ts

@@ -12,6 +12,13 @@ export const EXPOSES: Exposes = [
   'GET /domain/orgs/{org_id}/{domain}/settings',
   'POST /domain/orgs/{org_id}/{domain}/settings',
   'GET /domain/orgs/{org_id}/{domain}/status',
+  'GET /domain/orgs/{org_id}/{domain}/records',
+  'GET /domain/orgs/{org_id}/{domain}/records/{record_id}',
+  'POST /domain/orgs/{org_id}/{domain}/records',
+  'PATCH /domain/orgs/{org_id}/{domain}/records/{record_id}',
+  'DELETE /domain/orgs/{org_id}/{domain}/records/{record_id}',
+  'POST /domain/orgs/{org_id}/{domain}/email-infra',
+  'POST /domain/orgs/{org_id}/{domain}/retry-provisioning',
 ];
 
 
@@ -22,6 +29,19 @@ export interface DomainRecord {
   expires_at?: string;
   days_until_expiry?: number;
   email_infra_ready?: boolean;
+  // New status surface (post-2026-05-14 backend). Email infra is opt-in and
+  // always lives on a subdomain — apex is never touched.
+  email_infra?: 'skipped' | 'pending' | 'ready' | 'error';
+  email_subdomain?: string;          // Only set when email_infra ∈ {pending, ready, error}.
+  dns_active?: boolean;
+  steps_completed?: string[];
+  error_detail?: {
+    failed_step: string;
+    message: string;
+    retryable: boolean;
+    attempt_count?: number;
+    last_attempt_at?: string;
+  };
   org_id?: string | null;
   created_at: string;
 }
@@ -117,6 +137,84 @@ export async function getDomainSettings(apiKey: string, orgId: string, domain: s
   return request('GET', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/settings`, apiKey);
 }
 
+// ── DNS records ──────────────────────────────────────────────────────────────
+// Per-zone CRUD on the Cloudflare zone the backend manages for this domain.
+// v1 supports A / AAAA / CNAME / MX / TXT. `priority` is non-null only for MX,
+// `proxied` is non-null only for A/AAAA/CNAME. `ttl: 1` is CF's "automatic"
+// sentinel.
+
+export type DnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT';
+
+export interface DnsRecord {
+  id: string;
+  type: DnsRecordType;
+  name: string;          // FQDN as stored by CF
+  content: string;
+  ttl: number;
+  priority: number | null;
+  proxied: boolean | null;
+  created_on: string;
+  modified_on: string;
+}
+
+export interface DnsRecordInput {
+  type: DnsRecordType;
+  name: string;          // Accepts FQDN, host-only, or apex tokens (`@`, `""`).
+  content: string;
+  ttl?: number;          // Default 1 (CF auto). Range [60, 86400] otherwise.
+  priority?: number;     // Required for MX.
+  proxied?: boolean;     // A/AAAA/CNAME only. Defaults false.
+}
+
+export async function listDnsRecords(apiKey: string, orgId: string, domain: string, type?: DnsRecordType): Promise<DnsRecord[]> {
+  const query = type ? `?type=${encodeURIComponent(type)}` : '';
+  return request('GET', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records${query}`, apiKey);
+}
+
+export async function getDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string): Promise<DnsRecord> {
+  return request('GET', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey);
+}
+
+export async function createDnsRecord(apiKey: string, orgId: string, domain: string, input: DnsRecordInput): Promise<DnsRecord> {
+  return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records`, apiKey, input);
+}
+
+export async function updateDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string, input: Partial<Omit<DnsRecordInput, 'type'>>): Promise<DnsRecord> {
+  return request('PATCH', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey, input);
+}
+
+export async function deleteDnsRecord(apiKey: string, orgId: string, domain: string, recordId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/records/${encodeURIComponent(recordId)}`, apiKey);
+}
+
+// Opt in to MyAPI-managed email on a subdomain. Apex is never touched; the
+// backend provisions an SES identity on <subdomain>.<domain> and writes
+// DKIM/SPF/DMARC records there. Default subdomain is `mail`.
+export interface EmailInfraResponse {
+  domain: string;
+  email_infra: 'pending' | 'ready' | 'error';
+  email_subdomain: string;
+  next_step?: string;
+}
+
+export async function setupEmailInfra(apiKey: string, orgId: string, domain: string, subdomain?: string): Promise<EmailInfraResponse> {
+  const body = subdomain ? { subdomain } : {};
+  return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/email-infra`, apiKey, body);
+}
+
+// Re-run provisioning from the failed step when status=infra_error and the
+// error is retryable. Returns a transient `{ email_infra: 'pending', next_step }`
+// shape; caller polls `getDomainStatus` until status flips off `infra_error`.
+export interface RetryProvisioningResponse {
+  domain: string;
+  email_infra?: string;
+  next_step?: string;
+}
+
+export async function retryProvisioning(apiKey: string, orgId: string, domain: string): Promise<RetryProvisioningResponse> {
+  return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/retry-provisioning`, apiKey);
+}
+
 export async function updateDomainSettings(apiKey: string, orgId: string, domain: string, payload: {
   security_level?: 'essentially_off' | 'medium' | 'high' | 'under_attack';
   browser_check?: 'on' | 'off';