apinow-sdk 0.28.3 → 0.29.0

package/dist/cli.js

@@ -210,7 +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('--splits <json>', 'Splits JSON array. Each entry: {address, [basisPoints|amount|percent], label?, tokenAddress?}. Resolved basisPoints must sum to 10000.')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (opts) => {
     try {
@@ -245,7 +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('--splits <json>', 'Splits JSON array (entries accept basisPoints|amount|percent). Changing splits redeploys the splitter contract (V2 is immutable).')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (id, opts) => {
     try {
@@ -495,7 +495,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 +529,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 +654,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.0";
 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
@@ -143,7 +166,7 @@ export declare function createClient(config: ApinowConfig): {
         exampleQuery?: any;
         exampleOutput?: any;
         docsUrl?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
     }): Promise<any>;
     getEndpoint(id: string): Promise<any>;
     /**
@@ -163,7 +186,7 @@ export declare function createClient(config: ApinowConfig): {
             tokenSymbol?: string;
         }>;
         status?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         querySchema?: any;
         responseSchema?: any;
         exampleQuery?: any;
@@ -190,6 +213,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 +234,7 @@ export declare function createClient(config: ApinowConfig): {
         };
         prompt?: string;
         totalPrice?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         chain?: string;
     }): Promise<any>;
     /**
@@ -220,7 +249,7 @@ export declare function createClient(config: ApinowConfig): {
         description?: string;
         status?: string;
         totalPrice?: string;
-        splits?: SplitConfig[];
+        splits?: SplitInput[];
         graph?: {
             nodes: any[];
             outputNode: string;
@@ -263,7 +292,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.0';
 /**
  * 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
@@ -301,6 +301,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.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",