@myapihq/sdk 1.2.2 → 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;
 }
@@ -84,6 +95,19 @@ export declare function getDnsRecord(apiKey: string, orgId: string, domain: stri
 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

@@ -15,6 +15,8 @@ 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");
@@ -33,6 +35,8 @@ exports.EXPOSES = [
     '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);
@@ -82,6 +86,13 @@ async function updateDnsRecord(apiKey, orgId, domain, recordId, 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.2",
+  "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

@@ -17,6 +17,8 @@ export const EXPOSES: Exposes = [
   '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',
 ];
 
 
@@ -27,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;
 }
@@ -172,6 +187,34 @@ export async function deleteDnsRecord(apiKey: string, orgId: string, domain: str
   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';