apinow-sdk 0.27.0 → 0.28.0

package/dist/cli.js

@@ -210,6 +210,7 @@ program
     .requiredOption('--description <desc>', 'Description')
     .option('--method <method>', 'HTTP method', 'POST')
     .option('--price <usdc>', 'USDC price per call', '0.01')
+    .option('--splits <json>', 'Splits JSON array [{address, basisPoints, label?, tokenAddress?}] — basisPoints must sum to 10000')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (opts) => {
     try {
@@ -222,6 +223,8 @@ program
             httpMethod: opts.method.toUpperCase(),
             paymentOptions: [{ usdAmount: opts.price, amount: opts.price }],
         };
+        if (opts.splits)
+            body.splits = JSON.parse(opts.splits);
         const data = await fetchJson(`${API_BASE}/api/endpoints`, {
             method: 'POST',
             headers: await walletHeaders(privateKey),
@@ -242,6 +245,7 @@ program
     .option('--url <url>', 'New URL')
     .option('--price <usdc>', 'New USDC price')
     .option('--status <status>', 'New status')
+    .option('--splits <json>', 'Splits JSON array — changing splits redeploys the splitter contract (V2 is immutable)')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (id, opts) => {
     try {
@@ -255,6 +259,8 @@ program
             body.status = opts.status;
         if (opts.price)
             body.paymentOptions = [{ usdAmount: opts.price, amount: opts.price }];
+        if (opts.splits)
+            body.splits = JSON.parse(opts.splits);
         const data = await fetchJson(`${API_BASE}/api/endpoints/${id}`, {
             method: 'PUT',
             headers: await walletHeaders(privateKey),
@@ -518,11 +524,13 @@ program
 // ─── workflow-update ───
 program
     .command('workflow-update <id>')
-    .description('Update a workflow by ID')
-    .option('--name <name>', 'New name')
-    .option('--description <desc>', 'New description')
+    .description('Update a workflow by ID (price/splits/graph changes auto-create a new version)')
+    .option('--name <name>', 'New name (7-day cooldown; 429 if on cooldown)')
+    .option('--description <desc>', 'New description (7-day cooldown)')
     .option('--status <status>', 'New status')
-    .option('--price <usdc>', 'New total price')
+    .option('--price <usdc>', 'New total price — auto-bumps version')
+    .option('--splits <json>', 'Splits JSON array — auto-bumps version; redeploys splitter if structurally changed')
+    .option('--changelog <msg>', 'Label for the auto-created version snapshot')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (id, opts) => {
     try {
@@ -536,6 +544,10 @@ program
             body.status = opts.status;
         if (opts.price)
             body.totalPrice = opts.price;
+        if (opts.splits)
+            body.splits = JSON.parse(opts.splits);
+        if (opts.changelog)
+            body.changelog = opts.changelog;
         const data = await fetchJson(`${API_BASE}/api/workflows/${id}`, {
             method: 'PUT',
             headers: await walletHeaders(privateKey),

package/dist/index.d.ts

@@ -43,6 +43,25 @@ export interface ApinowBrowserConfig {
     paidFetch?: typeof globalThis.fetch;
 }
 export type ApinowConfig = ApinowServerConfig | ApinowBrowserConfig;
+export interface SplitConfig {
+    address: string;
+    basisPoints: number;
+    label?: string;
+    tokenAddress?: string;
+    recipientAddress?: string;
+}
+/**
+ * Thrown by authed writes when the backend returns a non-2xx. Exposes status
+ * code and parsed JSON body so callers can branch on e.g. 429 cooldowns
+ * without re-parsing error text.
+ */
+export declare class ApinowApiError extends Error {
+    readonly status: number;
+    readonly body: any;
+    readonly retryAfterMs?: number;
+    readonly retryAfterDays?: number;
+    constructor(status: number, body: any);
+}
 export interface GenerateUIOptions {
     endpointName: string;
     namespace: string;
@@ -98,6 +117,13 @@ export declare function createClient(config: ApinowConfig): {
      * Get public endpoint info (free, no payment).
      */
     info(namespace: string, endpointName: string): Promise<any>;
+    /**
+     * Create an endpoint. If `splits` are provided they must sum to exactly
+     * `10000` basis points; the server deploys a 0xSplits V2 splitter after
+     * creation and stores `splitterAddress` on the endpoint. Non-fatal if
+     * the splitter deploy fails — endpoint will exist without one and can be
+     * retried via `updateEndpoint({ splits })`.
+     */
     createEndpoint(config: {
         namespace: string;
         endpointName: string;
@@ -116,9 +142,34 @@ export declare function createClient(config: ApinowConfig): {
         exampleQuery?: any;
         exampleOutput?: any;
         docsUrl?: string;
+        splits?: SplitConfig[];
     }): Promise<any>;
     getEndpoint(id: string): Promise<any>;
-    updateEndpoint(id: string, updates: Record<string, any>): Promise<any>;
+    /**
+     * Update an endpoint. Changing `splits` (structurally) redeploys the
+     * splitter contract (V2 is immutable); the old address is archived on
+     * `previousSplitters[]` and the platform drains leftover USDC from it.
+     * `splits` must sum to `10000` basis points when non-empty.
+     */
+    updateEndpoint(id: string, updates: {
+        url?: string;
+        description?: string;
+        httpMethod?: "GET" | "POST";
+        paymentOptions?: Array<{
+            amount?: string;
+            usdAmount?: string;
+            tokenAddress?: string;
+            tokenSymbol?: string;
+        }>;
+        status?: string;
+        splits?: SplitConfig[];
+        querySchema?: any;
+        responseSchema?: any;
+        exampleQuery?: any;
+        exampleOutput?: any;
+        docsUrl?: string;
+        [key: string]: any;
+    }): Promise<any>;
     deleteEndpoint(id: string): Promise<any>;
     listEndpoints(opts?: {
         limit?: number;
@@ -153,15 +204,32 @@ export declare function createClient(config: ApinowConfig): {
         };
         prompt?: string;
         totalPrice?: string;
-        splits?: Array<{
-            address: string;
-            basisPoints: number;
-            label?: string;
-            tokenAddress?: string;
-        }>;
+        splits?: SplitConfig[];
         chain?: string;
     }): Promise<any>;
-    updateWorkflow(workflowId: string, updates: Record<string, any>): Promise<any>;
+    /**
+     * Update a workflow. Changing `graph`, `totalPrice`, or `splits`
+     * auto-creates a new `WorkflowVersion` snapshot server-side; pass
+     * `changelog` to label it. `name`/`description` are subject to a 7-day
+     * cooldown — throws `ApinowApiError` with `status=429` and `retryAfterMs`
+     * when the cooldown is active.
+     */
+    updateWorkflow(workflowId: string, updates: {
+        name?: string;
+        description?: string;
+        status?: string;
+        totalPrice?: string;
+        splits?: SplitConfig[];
+        graph?: {
+            nodes: any[];
+            outputNode: string;
+            outputMapping?: any;
+        };
+        executionMode?: "balanced" | "optimistic" | "settle_first";
+        mermaidDiagram?: string;
+        changelog?: string;
+        [key: string]: any;
+    }): Promise<any>;
     deleteWorkflow(workflowId: string): Promise<any>;
     /**
      * List workflows you created (convenience for `listWorkflows({ creator: yourWallet })`).
@@ -181,8 +249,11 @@ export declare function createClient(config: ApinowConfig): {
      */
     getWorkflowVersion(workflowId: string, versionIdOrNumber: string | number): Promise<any>;
     /**
-     * Create a new workflow version (creator only). Defaults to setting it as default.
-     * Omit fields to inherit from current workflow.
+     * Create a new workflow version (creator only). Defaults to setting it as
+     * default. Omit fields to inherit from current workflow. If `splits`
+     * differs from the current config, the server redeploys the 0xSplits V2
+     * contract and stores `splitterAddress` / `splitterTxHash` on the version.
+     * Splits basis points must sum to `10000`.
      */
     createWorkflowVersion(workflowId: string, updates?: {
         graph?: {
@@ -191,12 +262,7 @@ export declare function createClient(config: ApinowConfig): {
             outputMapping?: any;
         };
         totalPrice?: string;
-        splits?: Array<{
-            address: string;
-            basisPoints: number;
-            label?: string;
-            tokenAddress?: string;
-        }>;
+        splits?: SplitConfig[];
         mermaidDiagram?: string;
         executionMode?: "balanced" | "optimistic" | "settle_first";
         changelog?: string;

package/dist/index.js

@@ -5,6 +5,27 @@ const APINOW_BASE = 'https://apinow.fun';
 function isServerConfig(c) {
     return 'privateKey' in c && typeof c.privateKey === 'string';
 }
+/**
+ * Thrown by authed writes when the backend returns a non-2xx. Exposes status
+ * code and parsed JSON body so callers can branch on e.g. 429 cooldowns
+ * without re-parsing error text.
+ */
+export class ApinowApiError extends Error {
+    constructor(status, body) {
+        const msg = (body && typeof body === 'object' && (body.error || body.message)) ||
+            (typeof body === 'string' ? body : JSON.stringify(body));
+        super(`APINow ${status}: ${msg}`);
+        this.name = 'ApinowApiError';
+        this.status = status;
+        this.body = body;
+        if (body && typeof body === 'object') {
+            if (typeof body.retryAfterMs === 'number')
+                this.retryAfterMs = body.retryAfterMs;
+            if (typeof body.retryAfterDays === 'number')
+                this.retryAfterDays = body.retryAfterDays;
+        }
+    }
+}
 // ─── SDK ───
 // Prevent undici (Node 20+ / Vercel) from crashing when @x402/fetch retries
 // a POST with a cloned Request body stream and the server returns a 3xx redirect.
@@ -92,7 +113,14 @@ export function createClient(config) {
         const res = await authedFetch(url, init);
         if (!res.ok) {
             const text = await res.text();
-            throw new Error(`APINow ${res.status}: ${text}`);
+            let parsed = text;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // leave as text
+            }
+            throw new ApinowApiError(res.status, parsed);
         }
         return res.json();
     }
@@ -151,6 +179,13 @@ export function createClient(config) {
             return res.json();
         },
         // ─── Endpoint CRUD ───
+        /**
+         * Create an endpoint. If `splits` are provided they must sum to exactly
+         * `10000` basis points; the server deploys a 0xSplits V2 splitter after
+         * creation and stores `splitterAddress` on the endpoint. Non-fatal if
+         * the splitter deploy fails — endpoint will exist without one and can be
+         * retried via `updateEndpoint({ splits })`.
+         */
         async createEndpoint(config) {
             return authedJson(`${baseUrl}/api/endpoints`, {
                 method: 'POST',
@@ -163,6 +198,12 @@ export function createClient(config) {
                 throw new Error(`Failed to get endpoint: ${res.status}`);
             return res.json();
         },
+        /**
+         * Update an endpoint. Changing `splits` (structurally) redeploys the
+         * splitter contract (V2 is immutable); the old address is archived on
+         * `previousSplitters[]` and the platform drains leftover USDC from it.
+         * `splits` must sum to `10000` basis points when non-empty.
+         */
         async updateEndpoint(id, updates) {
             return authedJson(`${baseUrl}/api/endpoints/${id}`, {
                 method: 'PUT',
@@ -219,6 +260,13 @@ export function createClient(config) {
                 body: JSON.stringify(config),
             });
         },
+        /**
+         * Update a workflow. Changing `graph`, `totalPrice`, or `splits`
+         * auto-creates a new `WorkflowVersion` snapshot server-side; pass
+         * `changelog` to label it. `name`/`description` are subject to a 7-day
+         * cooldown — throws `ApinowApiError` with `status=429` and `retryAfterMs`
+         * when the cooldown is active.
+         */
         async updateWorkflow(workflowId, updates) {
             return authedJson(`${baseUrl}/api/workflows/${workflowId}`, {
                 method: 'PUT',
@@ -254,8 +302,11 @@ export function createClient(config) {
             return res.json();
         },
         /**
-         * Create a new workflow version (creator only). Defaults to setting it as default.
-         * Omit fields to inherit from current workflow.
+         * Create a new workflow version (creator only). Defaults to setting it as
+         * default. Omit fields to inherit from current workflow. If `splits`
+         * differs from the current config, the server redeploys the 0xSplits V2
+         * contract and stores `splitterAddress` / `splitterTxHash` on the version.
+         * Splits basis points must sum to `10000`.
          */
         async createWorkflowVersion(workflowId, updates = {}) {
             return authedJson(`${baseUrl}/api/workflows/${workflowId}/versions`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apinow-sdk",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Pay-per-call API SDK & CLI for APINow.fun — endpoints + workflows, wraps x402 so you don't have to",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",