apinow-sdk 0.28.3 → 0.29.1

package/dist/cli.js

@@ -210,7 +210,6 @@ 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 {
@@ -223,8 +222,6 @@ 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),
@@ -245,7 +242,6 @@ 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 {
@@ -259,8 +255,6 @@ 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),
@@ -495,7 +489,7 @@ program
     .option('--graph <json>', 'Graph JSON (nodes + outputNode)')
     .option('--prompt <prompt>', 'AI prompt to generate workflow')
     .option('--price <usdc>', 'Total price', '0.10')
-    .option('--splits <json>', 'Splits JSON array [{address, basisPoints, label?, tokenAddress?}]')
+    .option('--splits <json>', 'Splits JSON array. Each entry: {address, [basisPoints|amount|percent], label?, tokenAddress?}.')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (opts) => {
     try {
@@ -529,7 +523,7 @@ program
     .option('--description <desc>', 'New description (7-day cooldown)')
     .option('--status <status>', 'New status')
     .option('--price <usdc>', 'New total price — auto-bumps version')
-    .option('--splits <json>', 'Splits JSON array — auto-bumps version; redeploys splitter if structurally changed')
+    .option('--splits <json>', 'Splits JSON array (entries accept basisPoints|amount|percent). 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) => {
@@ -654,7 +648,7 @@ program
     .description('Create a new version of a workflow (graph/price/splits)')
     .option('--graph <json>', 'Graph JSON (inherits current if omitted)')
     .option('--price <usdc>', 'Total price')
-    .option('--splits <json>', 'Splits JSON array')
+    .option('--splits <json>', 'Splits JSON array (entries accept basisPoints|amount|percent)')
     .option('--changelog <msg>', 'Changelog message')
     .option('--no-default', 'Create as non-default (keeps current version active)')
     .option('-k, --key <privateKey>', 'Wallet private key')

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const APINOW_SDK_VERSION = "0.28.3";
+export declare const APINOW_SDK_VERSION = "0.29.1";
 export interface CallOptions {
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
     body?: Record<string, any>;
@@ -51,6 +51,29 @@ export interface SplitConfig {
     tokenAddress?: string;
     recipientAddress?: string;
 }
+/**
+ * A single split entry as accepted by the workflow write endpoints
+ * (create / update / new version). Specify EXACTLY ONE of
+ * `basisPoints`, `amount`, or `percent` — the backend normalizes to
+ * basis points against the workflow's `totalPrice`:
+ *
+ *   { address, basisPoints: 3000 }                     // 30.00 %
+ *   { address, amount: "0.05" }                        // USDC dollars
+ *   { address, percent: 30 }                           // 30.00 %
+ *
+ * The array as a whole must still sum to 10000 bps (100%). Mix and match
+ * per entry; amount / percent are just convenience forms so you don't
+ * have to compute bps manually.
+ */
+export interface SplitInput {
+    address: string;
+    label?: string;
+    tokenAddress?: string;
+    recipientAddress?: string;
+    basisPoints?: number;
+    amount?: number | string;
+    percent?: number | 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
@@ -118,13 +141,6 @@ 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;
@@ -143,15 +159,8 @@ export declare function createClient(config: ApinowConfig): {
         exampleQuery?: any;
         exampleOutput?: any;
         docsUrl?: string;
-        splits?: SplitConfig[];
     }): Promise<any>;
     getEndpoint(id: string): 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;
@@ -163,7 +172,6 @@ export declare function createClient(config: ApinowConfig): {
             tokenSymbol?: string;
         }>;
         status?: string;
-        splits?: SplitConfig[];
         querySchema?: any;
         responseSchema?: any;
         exampleQuery?: any;
@@ -190,6 +198,12 @@ export declare function createClient(config: ApinowConfig): {
      * Get workflow details by ID.
      */
     getWorkflow(workflowId: string): Promise<any>;
+    /**
+     * Create a workflow. `splits` accepts either `SplitConfig[]`
+     * (`basisPoints`) or the more ergonomic `SplitInput[]` — mix and
+     * match `basisPoints | amount | percent` per entry. The server
+     * normalizes to basis points against `totalPrice`.
+     */
     createWorkflow(config: {
         name?: string;
         description?: string;
@@ -205,7 +219,7 @@ export declare function createClient(config: ApinowConfig): {
         };
         prompt?: string;
         totalPrice?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         chain?: string;
     }): Promise<any>;
     /**
@@ -220,7 +234,7 @@ export declare function createClient(config: ApinowConfig): {
         description?: string;
         status?: string;
         totalPrice?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         graph?: {
             nodes: any[];
             outputNode: string;
@@ -263,7 +277,7 @@ export declare function createClient(config: ApinowConfig): {
             outputMapping?: any;
         };
         totalPrice?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         mermaidDiagram?: string;
         executionMode?: "balanced" | "optimistic" | "settle_first";
         changelog?: string;

package/dist/index.js

@@ -2,7 +2,7 @@ import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
 import { registerExactEvmScheme } from '@x402/evm/exact/client';
 import { privateKeyToAccount } from 'viem/accounts';
 const APINOW_BASE = 'https://www.apinow.fun';
-export const APINOW_SDK_VERSION = '0.28.3';
+export const APINOW_SDK_VERSION = '0.29.1';
 /**
  * Default base URL. In a browser we prefer the current origin so that
  * signed-auth writes stay same-origin and don't hit a CORS preflight
@@ -226,13 +226,6 @@ 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',
@@ -245,12 +238,6 @@ 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',
@@ -301,6 +288,12 @@ export function createClient(config) {
                 throw new Error(`Failed to get workflow: ${res.status}`);
             return res.json();
         },
+        /**
+         * Create a workflow. `splits` accepts either `SplitConfig[]`
+         * (`basisPoints`) or the more ergonomic `SplitInput[]` — mix and
+         * match `basisPoints | amount | percent` per entry. The server
+         * normalizes to basis points against `totalPrice`.
+         */
         async createWorkflow(config) {
             return authedJson(`${baseUrl}/api/workflows`, {
                 method: 'POST',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apinow-sdk",
-  "version": "0.28.3",
+  "version": "0.29.1",
   "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",