@myapihq/sdk 1.2.2 → 1.2.5

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/config.d.ts

@@ -1,6 +1,7 @@
 export declare const HQ_BASE: string;
 export declare const DOMAIN_BASE: string;
 export declare const FUNNEL_BASE: string;
+export declare const FUNCTION_BASE: string;
 export declare const IMAGE_BASE: string;
 export declare const WEBHOOK_BASE: string;
 export declare const WORKFLOW_BASE: string;

package/dist/config.js

@@ -8,11 +8,14 @@
 // local dev — `source scripts/local-env.sh` still points everything at
 // localhost:8080 regardless of the prod default.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CRM_BASE = exports.DATABASE_BASE = exports.LLM_BASE = exports.AUDIENCE_BASE = exports.COMPANY_BASE = exports.PEOPLE_BASE = exports.PIXEL_BASE = exports.URL_BASE = exports.STORAGE_BASE = exports.EMAIL_BASE = exports.WORKFLOW_BASE = exports.WEBHOOK_BASE = exports.IMAGE_BASE = exports.FUNNEL_BASE = exports.DOMAIN_BASE = exports.HQ_BASE = void 0;
+exports.CRM_BASE = exports.DATABASE_BASE = exports.LLM_BASE = exports.AUDIENCE_BASE = exports.COMPANY_BASE = exports.PEOPLE_BASE = exports.PIXEL_BASE = exports.URL_BASE = exports.STORAGE_BASE = exports.EMAIL_BASE = exports.WORKFLOW_BASE = exports.WEBHOOK_BASE = exports.IMAGE_BASE = exports.FUNCTION_BASE = exports.FUNNEL_BASE = exports.DOMAIN_BASE = exports.HQ_BASE = void 0;
 const GATEWAY = 'https://api.myapihq.com';
 exports.HQ_BASE = process.env.MYAPI_HQ_URL ?? process.env.MYAPI_API_BASE ?? GATEWAY;
 exports.DOMAIN_BASE = process.env.MYAPI_DOMAIN_URL ?? 'https://api.mydomainapi.com';
 exports.FUNNEL_BASE = process.env.MYAPI_FUNNEL_URL ?? 'https://api.myfunnelapi.com';
+// New slots — routed via the gateway until brand hosts are DNS-wired
+// (mirrors the LLM/DATABASE/CRM pattern below).
+exports.FUNCTION_BASE = process.env.MYAPI_FUNCTION_URL ?? GATEWAY;
 exports.IMAGE_BASE = process.env.MYAPI_IMAGE_URL ?? 'https://api.myimageapi.com';
 exports.WEBHOOK_BASE = process.env.MYAPI_WEBHOOK_URL ?? 'https://api.mywebhookapi.com';
 exports.WORKFLOW_BASE = process.env.MYAPI_WORKFLOW_URL ?? 'https://api.myworkflowapi.com';

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;
 }
@@ -56,8 +67,17 @@ export interface ImportDomainResponse {
 export declare function importDomain(apiKey: string, orgId: string, domain: string): Promise<ImportDomainResponse>;
 export declare function listDomains(apiKey: string, orgId: string, filter?: string): Promise<DomainRecord[]>;
 export declare function getDomainStatus(apiKey: string, orgId: string, domain: string): Promise<DomainRecord>;
-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 interface AssignDomainResponse {
+    domain: string;
+    org_id: string | null;
+    include_www: boolean;
+    routes_bound: string[];
+}
+export declare function assignDomain(apiKey: string, orgId: string, domain: string, opts?: {
+    includeWww?: boolean;
+    funnelId?: string;
+}): Promise<AssignDomainResponse>;
+export declare function unassignDomain(apiKey: string, orgId: string, domain: string): Promise<AssignDomainResponse>;
 export declare function getDomainSettings(apiKey: string, orgId: string, domain: string): Promise<DomainSettings>;
 export type DnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT';
 export interface DnsRecord {
@@ -84,6 +104,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);
@@ -57,8 +61,18 @@ async function listDomains(apiKey, orgId, filter) {
 async function getDomainStatus(apiKey, orgId, domain) {
     return (0, client_1.request)('GET', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/status`, apiKey);
 }
-async function assignDomain(apiKey, orgId, domain) {
-    return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, { org_id: orgId });
+async function assignDomain(apiKey, orgId, domain, opts) {
+    const body = { org_id: orgId };
+    if (opts?.includeWww === false)
+        body.include_www = false;
+    // Backend (2026-05-15): optional funnel_id picks which funnel the domain
+    // is bound to. Defaults server-side to the org's only funnel (or first
+    // when ambiguous, today; will become required once N-funnels-per-org lands
+    // for real). Pre-emptively threading it through gives agents a way to be
+    // explicit when the migration completes without an SDK shape change.
+    if (opts?.funnelId)
+        body.funnel_id = opts.funnelId;
+    return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, body);
 }
 async function unassignDomain(apiKey, orgId, domain) {
     return (0, client_1.request)('POST', `${config_1.DOMAIN_BASE}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, { org_id: null });
@@ -82,6 +96,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/dist/function.d.ts

@@ -0,0 +1,27 @@
+import type { Exposes } from './exposes';
+export declare const EXPOSES: Exposes;
+export type TriggerType = 'http' | 'cron';
+export interface Fn {
+    id: string;
+    org_id: string;
+    name: string;
+    trigger_type: TriggerType;
+    cron_schedule?: string;
+    invocation_url: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreatePayload {
+    name: string;
+    trigger_type?: TriggerType;
+    cron_schedule?: string;
+}
+export interface CreateResponse {
+    function: Fn;
+    scoped_api_key: string;
+    scoped_api_key_id: string;
+}
+export declare function createFunction(apiKey: string, orgId: string, payload: CreatePayload): Promise<CreateResponse>;
+export declare function listFunctions(apiKey: string, orgId: string): Promise<Fn[]>;
+export declare function getFunction(apiKey: string, orgId: string, fnId: string): Promise<Fn>;
+export declare function deleteFunction(apiKey: string, orgId: string, fnId: string): Promise<void>;

package/dist/function.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPOSES = void 0;
+exports.createFunction = createFunction;
+exports.listFunctions = listFunctions;
+exports.getFunction = getFunction;
+exports.deleteFunction = deleteFunction;
+const client_1 = require("./client");
+const config_1 = require("./config");
+// Backend: Story 1 (per myapi-hq/internal/routes/function/crud.go). Metadata
+// + scoped API key issuance only — Cloudflare Worker upload, /logs, and /env
+// land in Story 2-5. The SDK surface stays minimal until those endpoints
+// exist; do not add forward-compat fields here that the backend will silently
+// ignore.
+exports.EXPOSES = [
+    'POST /function/orgs/{org_id}/functions',
+    'GET /function/orgs/{org_id}/functions',
+    'GET /function/orgs/{org_id}/functions/{id}',
+    'DELETE /function/orgs/{org_id}/functions/{id}',
+];
+async function createFunction(apiKey, orgId, payload) {
+    return (0, client_1.request)('POST', `${config_1.FUNCTION_BASE}/function/orgs/${encodeURIComponent(orgId)}/functions`, apiKey, payload);
+}
+async function listFunctions(apiKey, orgId) {
+    return (0, client_1.request)('GET', `${config_1.FUNCTION_BASE}/function/orgs/${encodeURIComponent(orgId)}/functions`, apiKey);
+}
+async function getFunction(apiKey, orgId, fnId) {
+    return (0, client_1.request)('GET', `${config_1.FUNCTION_BASE}/function/orgs/${encodeURIComponent(orgId)}/functions/${encodeURIComponent(fnId)}`, apiKey);
+}
+async function deleteFunction(apiKey, orgId, fnId) {
+    return (0, client_1.request)('DELETE', `${config_1.FUNCTION_BASE}/function/orgs/${encodeURIComponent(orgId)}/functions/${encodeURIComponent(fnId)}`, apiKey);
+}

package/dist/funnel.d.ts

@@ -3,6 +3,7 @@ export declare const EXPOSES: Exposes;
 export interface Funnel {
     id: string;
     org_id: string;
+    name?: string;
     created_at: string;
     updated_at: string;
 }
@@ -24,7 +25,9 @@ export interface VerifyTest {
     passed: boolean;
     details: string;
 }
-export declare function createFunnel(apiKey: string, orgId: string): Promise<CreateFunnelResponse>;
+export declare function createFunnel(apiKey: string, orgId: string, opts?: {
+    name?: string;
+}): Promise<CreateFunnelResponse>;
 export declare function getFunnel(apiKey: string, orgId: string, funnelId: string): Promise<Funnel>;
 export declare function listFunnels(apiKey: string, orgId: string): Promise<Funnel[]>;
 export declare function deleteFunnel(apiKey: string, orgId: string, funnelId: string): Promise<void>;

package/dist/funnel.js

@@ -19,8 +19,10 @@ exports.EXPOSES = [
     '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, {});
+async function createFunnel(apiKey, orgId, opts) {
+    // v2: accept optional name for N-funnels-per-org. Backend rejects names
+    // matching the reserved-suffix rules; agent should pre-validate.
+    return (0, client_1.request)('POST', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey, opts?.name ? { name: opts.name } : {});
 }
 async function getFunnel(apiKey, orgId, funnelId) {
     return (0, client_1.request)('GET', `${config_1.FUNNEL_BASE}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}`, apiKey);

package/dist/index.d.ts

@@ -16,3 +16,4 @@ export * as audience from './audience';
 export * as llm from './llm';
 export * as database from './database';
 export * as crm from './crm';
+export * as fn from './function';

package/dist/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.fn = 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);
 // Note: config constants (STORAGE_BASE etc.) are NOT re-exported from the
@@ -61,3 +61,4 @@ exports.audience = __importStar(require("./audience"));
 exports.llm = __importStar(require("./llm"));
 exports.database = __importStar(require("./database"));
 exports.crm = __importStar(require("./crm"));
+exports.fn = __importStar(require("./function"));

package/dist/services.js

@@ -187,4 +187,21 @@ exports.SERVICES = [
         status: 'ga',
         keywords: k('llm', 'completion', 'embedding', 'gemini'),
     },
+    {
+        // CLI top-level command is `fn`; SDK namespace is `fn`; skill directory is
+        // `my-function-api` (the agent-discoverable brand name).
+        //
+        // Backend status: Story 1 shipped (metadata + scoped API key issuance).
+        // Story 2 (CF Workers upload, invocation URL), Story 4 (/logs), Story 5
+        // (/env) pending. 'planned' reflects "partial backend, not stable GA."
+        module: 'fn',
+        skill: 'my-function-api',
+        domain: 'myfunctionapi.com',
+        description: 'Run JavaScript functions on the edge. HTTP or cron triggers. Pre-injected MYAPI SDK scoped to the org — no auth tokens in user code.',
+        category: 'compute',
+        status: 'planned',
+        keywords: k('function', 'serverless', 'edge', 'cloudflare-workers', 'http-handler', 'cron'),
+    },
+    // Note: my-payments-api removed from registry — backend has no /payments/*
+    // endpoints yet. Re-add when backend ships per tech-spec-my-payments-api-2026-05-14.md.
 ];

package/dist/webhook.d.ts

@@ -19,8 +19,16 @@ export interface Delivery {
 export interface CreateEndpointOptions {
     description?: string;
     crm_email_path?: string;
+    forward_url?: string;
+}
+export interface UpdateEndpointPayload {
+    name?: string;
+    description?: string;
+    crm_email_path?: string;
+    forward_url?: string;
 }
 export declare function createEndpoint(apiKey: string, orgId: string, name: string, opts?: CreateEndpointOptions): Promise<WebhookEndpoint>;
+export declare function updateEndpoint(apiKey: string, orgId: string, endpointId: string, payload: UpdateEndpointPayload): Promise<WebhookEndpoint>;
 export declare function listEndpoints(apiKey: string, orgId: string): Promise<WebhookEndpoint[]>;
 export declare function deleteEndpoint(apiKey: string, orgId: string, endpointId: string): Promise<void>;
 export declare function getDelivery(apiKey: string, orgId: string, deliveryId: string): Promise<Delivery>;

package/dist/webhook.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EXPOSES = void 0;
 exports.createEndpoint = createEndpoint;
+exports.updateEndpoint = updateEndpoint;
 exports.listEndpoints = listEndpoints;
 exports.deleteEndpoint = deleteEndpoint;
 exports.getDelivery = getDelivery;
@@ -10,6 +11,7 @@ const config_1 = require("./config");
 exports.EXPOSES = [
     'POST /webhook/orgs/{org_id}/endpoints',
     'GET /webhook/orgs/{org_id}/endpoints',
+    'PATCH /webhook/orgs/{org_id}/endpoints/{endpoint_id}',
     'DELETE /webhook/orgs/{org_id}/endpoints/{endpoint_id}',
     'GET /webhook/orgs/{org_id}/deliveries/{delivery_id}',
 ];
@@ -19,8 +21,13 @@ async function createEndpoint(apiKey, orgId, name, opts = {}) {
         body.description = opts.description;
     if (opts.crm_email_path !== undefined)
         body.crm_email_path = opts.crm_email_path;
+    if (opts.forward_url !== undefined)
+        body.forward_url = opts.forward_url;
     return (0, client_1.request)('POST', `${config_1.WEBHOOK_BASE}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints`, apiKey, body);
 }
+async function updateEndpoint(apiKey, orgId, endpointId, payload) {
+    return (0, client_1.request)('PATCH', `${config_1.WEBHOOK_BASE}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints/${encodeURIComponent(endpointId)}`, apiKey, payload);
+}
 async function listEndpoints(apiKey, orgId) {
     return (0, client_1.request)('GET', `${config_1.WEBHOOK_BASE}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints`, apiKey);
 }

package/dist/workflow.d.ts

@@ -22,6 +22,12 @@ export type WorkflowStep = {
     type: 'slack_message';
     webhook_url: string;
     text: string;
+} | {
+    type: 'http_request' | 'http';
+    url: string;
+    method?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+    body?: string;
+    headers?: Record<string, string>;
 };
 export interface Workflow {
     id: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/sdk",
   "license": "Apache-2.0",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "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/config.ts

@@ -12,6 +12,9 @@ const GATEWAY = 'https://api.myapihq.com';
 export const HQ_BASE     = process.env.MYAPI_HQ_URL     ?? process.env.MYAPI_API_BASE ?? GATEWAY;
 export const DOMAIN_BASE  = process.env.MYAPI_DOMAIN_URL  ?? 'https://api.mydomainapi.com';
 export const FUNNEL_BASE  = process.env.MYAPI_FUNNEL_URL  ?? 'https://api.myfunnelapi.com';
+// New slots — routed via the gateway until brand hosts are DNS-wired
+// (mirrors the LLM/DATABASE/CRM pattern below).
+export const FUNCTION_BASE= process.env.MYAPI_FUNCTION_URL?? GATEWAY;
 export const IMAGE_BASE   = process.env.MYAPI_IMAGE_URL   ?? 'https://api.myimageapi.com';
 export const WEBHOOK_BASE = process.env.MYAPI_WEBHOOK_URL ?? 'https://api.mywebhookapi.com';
 export const WORKFLOW_BASE= process.env.MYAPI_WORKFLOW_URL?? 'https://api.myworkflowapi.com';

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;
 }
@@ -110,11 +125,29 @@ export async function getDomainStatus(apiKey: string, orgId: string, domain: str
   return request('GET', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/status`, apiKey);
 }
 
-export async function assignDomain(apiKey: string, orgId: string, domain: string): Promise<DomainRecord> {
-  return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, { org_id: orgId });
+// Assign returns the bound Worker routes so the CLI can show users what's
+// live without hardcoding "apex + www" (which would skew if backend changes
+// the default convention). `include_www` defaults to true at the backend.
+export interface AssignDomainResponse {
+  domain: string;
+  org_id: string | null;
+  include_www: boolean;
+  routes_bound: string[];
+}
+
+export async function assignDomain(apiKey: string, orgId: string, domain: string, opts?: { includeWww?: boolean; funnelId?: string }): Promise<AssignDomainResponse> {
+  const body: Record<string, unknown> = { org_id: orgId };
+  if (opts?.includeWww === false) body.include_www = false;
+  // Backend (2026-05-15): optional funnel_id picks which funnel the domain
+  // is bound to. Defaults server-side to the org's only funnel (or first
+  // when ambiguous, today; will become required once N-funnels-per-org lands
+  // for real). Pre-emptively threading it through gives agents a way to be
+  // explicit when the migration completes without an SDK shape change.
+  if (opts?.funnelId) body.funnel_id = opts.funnelId;
+  return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, body);
 }
 
-export async function unassignDomain(apiKey: string, orgId: string, domain: string): Promise<DomainRecord> {
+export async function unassignDomain(apiKey: string, orgId: string, domain: string): Promise<AssignDomainResponse> {
   return request('POST', `${BASE_URL}/domain/orgs/${encodeURIComponent(orgId)}/${encodeURIComponent(domain)}/assign`, apiKey, { org_id: null });
 }
 
@@ -172,6 +205,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';

package/src/function.ts

@@ -0,0 +1,63 @@
+import { request } from './client';
+import { FUNCTION_BASE as BASE_URL } from './config';
+import type { Exposes } from './exposes';
+
+// Backend: Story 1 (per myapi-hq/internal/routes/function/crud.go). Metadata
+// + scoped API key issuance only — Cloudflare Worker upload, /logs, and /env
+// land in Story 2-5. The SDK surface stays minimal until those endpoints
+// exist; do not add forward-compat fields here that the backend will silently
+// ignore.
+export const EXPOSES: Exposes = [
+  'POST /function/orgs/{org_id}/functions',
+  'GET /function/orgs/{org_id}/functions',
+  'GET /function/orgs/{org_id}/functions/{id}',
+  'DELETE /function/orgs/{org_id}/functions/{id}',
+];
+
+export type TriggerType = 'http' | 'cron';
+
+// Mirrors the backend's `Function` struct in crud.go. `invocation_url`
+// stays an empty string in Story 1; populated by Story 2 once the CF Worker
+// upload pipeline lands.
+export interface Fn {
+  id: string;
+  org_id: string;
+  name: string;
+  trigger_type: TriggerType;
+  cron_schedule?: string;
+  invocation_url: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreatePayload {
+  name: string;                        // required; ^[a-z0-9][a-z0-9-]{0,49}$
+  trigger_type?: TriggerType;          // optional, defaults to 'http' server-side
+  cron_schedule?: string;              // required if trigger_type === 'cron'
+}
+
+// POST response envelope includes the scoped API key — returned ONCE. The
+// caller must persist it if they want to use it directly; the SDK does not
+// store it. Story 2+ will use this key internally inside the function's
+// runtime shim (`globalThis.MYAPI`).
+export interface CreateResponse {
+  function: Fn;
+  scoped_api_key: string;
+  scoped_api_key_id: string;
+}
+
+export async function createFunction(apiKey: string, orgId: string, payload: CreatePayload): Promise<CreateResponse> {
+  return request('POST', `${BASE_URL}/function/orgs/${encodeURIComponent(orgId)}/functions`, apiKey, payload);
+}
+
+export async function listFunctions(apiKey: string, orgId: string): Promise<Fn[]> {
+  return request('GET', `${BASE_URL}/function/orgs/${encodeURIComponent(orgId)}/functions`, apiKey);
+}
+
+export async function getFunction(apiKey: string, orgId: string, fnId: string): Promise<Fn> {
+  return request('GET', `${BASE_URL}/function/orgs/${encodeURIComponent(orgId)}/functions/${encodeURIComponent(fnId)}`, apiKey);
+}
+
+export async function deleteFunction(apiKey: string, orgId: string, fnId: string): Promise<void> {
+  return request('DELETE', `${BASE_URL}/function/orgs/${encodeURIComponent(orgId)}/functions/${encodeURIComponent(fnId)}`, apiKey);
+}

package/src/funnel.ts

@@ -12,9 +12,16 @@ export const EXPOSES: Exposes = [
   'GET /funnel/orgs/{org_id}/funnels/{funnel_id}/pages',
 ];
 
-
-
-export interface Funnel { id: string; org_id: string; created_at: string; updated_at: string }
+export interface Funnel {
+  id: string;
+  org_id: string;
+  // Backend (2026-05-15): POST /funnels now accepts optional `name`. Defaults
+  // to the org's preview_subdomain for back-compat. Get / list responses
+  // include it when set.
+  name?: string;
+  created_at: string;
+  updated_at: string;
+}
 export interface CreateFunnelResponse { funnel: Funnel; subdomain_url?: string; domain_url?: string }
 export interface VerifyResult {
   pages?: Array<{ slug: string; tests: VerifyTest[] }>;
@@ -22,8 +29,10 @@ export interface VerifyResult {
 }
 export interface VerifyTest { type: 'link' | 'webhook'; url: string; passed: boolean; details: string }
 
-export async function createFunnel(apiKey: string, orgId: string): Promise<CreateFunnelResponse> {
-  return request('POST', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey, {});
+export async function createFunnel(apiKey: string, orgId: string, opts?: { name?: string }): Promise<CreateFunnelResponse> {
+  // v2: accept optional name for N-funnels-per-org. Backend rejects names
+  // matching the reserved-suffix rules; agent should pre-validate.
+  return request('POST', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels`, apiKey, opts?.name ? { name: opts.name } : {});
 }
 export async function getFunnel(apiKey: string, orgId: string, funnelId: string): Promise<Funnel> {
   return request('GET', `${BASE_URL}/funnel/orgs/${encodeURIComponent(orgId)}/funnels/${encodeURIComponent(funnelId)}`, apiKey);

package/src/index.ts

@@ -22,3 +22,4 @@ export * as audience from './audience';
 export * as llm from './llm';
 export * as database from './database';
 export * as crm from './crm';
+export * as fn from './function';

package/src/services.ts

@@ -217,4 +217,21 @@ export const SERVICES: readonly ServiceMeta[] = [
     status: 'ga',
     keywords: k('llm', 'completion', 'embedding', 'gemini'),
   },
+  {
+    // CLI top-level command is `fn`; SDK namespace is `fn`; skill directory is
+    // `my-function-api` (the agent-discoverable brand name).
+    //
+    // Backend status: Story 1 shipped (metadata + scoped API key issuance).
+    // Story 2 (CF Workers upload, invocation URL), Story 4 (/logs), Story 5
+    // (/env) pending. 'planned' reflects "partial backend, not stable GA."
+    module: 'fn',
+    skill: 'my-function-api',
+    domain: 'myfunctionapi.com',
+    description: 'Run JavaScript functions on the edge. HTTP or cron triggers. Pre-injected MYAPI SDK scoped to the org — no auth tokens in user code.',
+    category: 'compute',
+    status: 'planned',
+    keywords: k('function', 'serverless', 'edge', 'cloudflare-workers', 'http-handler', 'cron'),
+  },
+  // Note: my-payments-api removed from registry — backend has no /payments/*
+  // endpoints yet. Re-add when backend ships per tech-spec-my-payments-api-2026-05-14.md.
 ] as const;

package/src/webhook.ts

@@ -5,6 +5,7 @@ import type { Exposes } from './exposes';
 export const EXPOSES: Exposes = [
   'POST /webhook/orgs/{org_id}/endpoints',
   'GET /webhook/orgs/{org_id}/endpoints',
+  'PATCH /webhook/orgs/{org_id}/endpoints/{endpoint_id}',
   'DELETE /webhook/orgs/{org_id}/endpoints/{endpoint_id}',
   'GET /webhook/orgs/{org_id}/deliveries/{delivery_id}',
 ];
@@ -36,15 +37,34 @@ export interface CreateEndpointOptions {
   // 'email' (top-level). For nested shapes pass the dot-path (e.g.
   // 'data.object.customer_email' for Stripe, 'sender.email' for GitHub).
   crm_email_path?: string;
+  // Backend (2026-05-15): optional URL to forward every inbound delivery to
+  // (POST, async, best-effort). Headers `X-MyAPI-Webhook-Endpoint-Id` and
+  // `X-MyAPI-Webhook-Delivery-Id` are attached. Use http:// or https://.
+  // Empty string disables forwarding.
+  forward_url?: string;
+}
+
+// All fields optional — only those passed are mutated. Mirrors the backend
+// PATCH /webhook/orgs/{org_id}/endpoints/{id} contract (slug is immutable).
+export interface UpdateEndpointPayload {
+  name?: string;
+  description?: string;
+  crm_email_path?: string;
+  forward_url?: string;
 }
 
 export async function createEndpoint(apiKey: string, orgId: string, name: string, opts: CreateEndpointOptions = {}): Promise<WebhookEndpoint> {
   const body: Record<string, unknown> = { name };
   if (opts.description !== undefined) body.description = opts.description;
   if (opts.crm_email_path !== undefined) body.crm_email_path = opts.crm_email_path;
+  if (opts.forward_url !== undefined) body.forward_url = opts.forward_url;
   return request('POST', `${BASE_URL}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints`, apiKey, body);
 }
 
+export async function updateEndpoint(apiKey: string, orgId: string, endpointId: string, payload: UpdateEndpointPayload): Promise<WebhookEndpoint> {
+  return request('PATCH', `${BASE_URL}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints/${encodeURIComponent(endpointId)}`, apiKey, payload);
+}
+
 export async function listEndpoints(apiKey: string, orgId: string): Promise<WebhookEndpoint[]> {
   return request('GET', `${BASE_URL}/webhook/orgs/${encodeURIComponent(orgId)}/endpoints`, apiKey);
 }

package/src/workflow.ts

@@ -29,7 +29,11 @@ export const EXPOSES: Exposes = [
  */
 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 };
+  | { type: 'slack_message'; webhook_url: string; text: string }
+  // Backend (2026-05-15): `http_request` step is now accepted (alias: `http`).
+  // POSTs (or other method) to `url` with the inbound payload; supports
+  // template substitution in url/body the same way email steps do.
+  | { type: 'http_request' | 'http'; url: string; method?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE'; body?: string; headers?: Record<string, string> };
 
 export interface Workflow {
   id: string;