apinow-sdk 0.18.0 → 0.20.0

package/dist/cli.js

@@ -7,7 +7,7 @@ const program = new Command();
 program
     .name('apinow')
     .description('CLI for APINow.fun — search, inspect, and call pay-per-request APIs')
-    .version('0.17.0');
+    .version('0.20.0');
 // ─── Helpers ───
 function getPrivateKey(opts) {
     const raw = opts.key || process.env.APINOW_WALLET_PKEY || process.env.PRIVATE_KEY;
@@ -311,6 +311,72 @@ program
         process.exit(1);
     }
 });
+// ─── discover (external x402) ───
+program
+    .command('discover <url>')
+    .description('Discover the x402 price of any external endpoint (free)')
+    .option('-m, --method <method>', 'HTTP method the target expects', 'POST')
+    .action(async (url, opts) => {
+    try {
+        const params = new URLSearchParams({ url, method: opts.method.toUpperCase() });
+        const data = await fetchJson(`${API_BASE}/api/x402-proxy?${params}`);
+        console.log(`\n  ${data.url}`);
+        console.log(`  ${'─'.repeat(50)}`);
+        console.log(`  Method:          ${data.method}`);
+        console.log(`  x402 endpoint:   ${data.isX402 ? 'YES' : 'NO'}`);
+        console.log(`  Upstream price:  ${data.upstreamPrice}`);
+        console.log(`  Proxy fee:       ${data.proxyFee}`);
+        console.log(`  Total price:     ${data.totalPrice}`);
+        console.log(`  Network:         ${data.network}`);
+        if (data.upstreamAccepts?.length) {
+            console.log(`  Accepts:`);
+            for (const a of data.upstreamAccepts) {
+                console.log(`    scheme=${a.scheme} payTo=${a.payTo?.substring(0, 16)}…`);
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+// ─── call-external (external x402 proxy) ───
+program
+    .command('call-external <url>')
+    .description('Call any external x402 endpoint through the APINow proxy (paid)')
+    .option('-d, --data <json>', 'JSON body to send to the target')
+    .option('-m, --method <method>', 'HTTP method', 'POST')
+    .option('-H, --header <kv...>', 'Extra headers as key:value pairs')
+    .option('-k, --key <privateKey>', 'Wallet private key')
+    .action(async (url, opts) => {
+    try {
+        const privateKey = getPrivateKey(opts);
+        const body = opts.data ? JSON.parse(opts.data) : undefined;
+        const headers = {};
+        if (opts.header) {
+            for (const h of opts.header) {
+                const idx = h.indexOf(':');
+                if (idx > 0)
+                    headers[h.slice(0, idx).trim()] = h.slice(idx + 1).trim();
+            }
+        }
+        const params = new URLSearchParams({ url, method: opts.method.toUpperCase() });
+        const priceData = await fetchJson(`${API_BASE}/api/x402-proxy?${params}`);
+        console.error(`Calling ${url} [${opts.method.toUpperCase()}] — total cost: ${priceData.totalPrice} (upstream: ${priceData.upstreamPrice} + fee: ${priceData.proxyFee})`);
+        const apinow = createClient({ privateKey });
+        const result = await apinow.callExternal(url, {
+            method: opts.method.toUpperCase(),
+            ...(body ? { body } : {}),
+            ...(Object.keys(headers).length ? { headers } : {}),
+        });
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
 // ─── workflows ───
 program
     .command('workflows')
@@ -416,6 +482,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('-k, --key <privateKey>', 'Wallet private key')
     .action(async (opts) => {
     try {
@@ -427,6 +494,8 @@ program
             body.graph = JSON.parse(opts.graph);
         if (opts.prompt)
             body.prompt = opts.prompt;
+        if (opts.splits)
+            body.splits = JSON.parse(opts.splits);
         const data = await fetchJson(`${API_BASE}/api/workflows`, {
             method: 'POST',
             headers: walletHeaders(address),
@@ -622,6 +691,10 @@ program
     .description('Create a markup workflow that wraps an existing endpoint')
     .option('--markup <percent>', 'Markup percentage', '20')
     .option('--name <name>', 'Workflow name')
+    .option('--token-buy-percent <percent>', 'Percent of markup allocated to token buy')
+    .option('--token-buy-recipient <wallet>', 'Wallet to receive token buy USDC')
+    .option('--token-buy-ca <address>', 'Token contract address (default: $APINOW)')
+    .option('--markup-recipient <wallet>', 'Wallet to receive markup USDC')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (endpointId, opts) => {
     try {
@@ -629,7 +702,16 @@ program
         const body = { endpointId, markupPercent: Number(opts.markup) };
         if (opts.name)
             body.workflowName = opts.name;
-        console.error(`Creating markup workflow (${opts.markup}%)…`);
+        if (opts.tokenBuyPercent)
+            body.tokenBuyPercent = Number(opts.tokenBuyPercent);
+        if (opts.tokenBuyRecipient)
+            body.tokenBuyRecipient = opts.tokenBuyRecipient;
+        if (opts.tokenBuyCa)
+            body.tokenBuyCA = opts.tokenBuyCa;
+        if (opts.markupRecipient)
+            body.markupRecipient = opts.markupRecipient;
+        const tbLabel = opts.tokenBuyPercent ? ` + ${opts.tokenBuyPercent}% token buy` : '';
+        console.error(`Creating markup workflow (${opts.markup}%${tbLabel})…`);
         const data = await fetchJson(`${API_BASE}/api/user-factory/markup`, {
             method: 'POST',
             headers: walletHeaders(address),
@@ -640,6 +722,8 @@ program
         console.log(`  ID:      ${w.workflowId}`);
         console.log(`  Base:    $${w.basePrice} USDC`);
         console.log(`  Markup:  ${w.markupPercent}%`);
+        if (w.tokenBuyPercent)
+            console.log(`  Token Buy: ${w.tokenBuyPercent}% of markup`);
         console.log(`  Total:   $${w.totalPrice} USDC`);
         console.log(`  View:    https://apinow.fun${w.viewUrl}\n`);
     }

package/dist/index.d.ts

@@ -3,6 +3,21 @@ export interface CallOptions {
     body?: Record<string, any>;
     headers?: Record<string, string>;
 }
+export interface ExternalCallOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: Record<string, any>;
+    headers?: Record<string, string>;
+}
+export interface PriceDiscovery {
+    url: string;
+    method: string;
+    isX402: boolean;
+    upstreamPrice: string;
+    proxyFee: string;
+    totalPrice: string;
+    network: string;
+    upstreamAccepts: any[];
+}
 export interface ApinowConfig {
     privateKey: `0x${string}`;
     baseUrl?: string;
@@ -86,6 +101,7 @@ export declare function createClient(config: ApinowConfig): {
             address: string;
             basisPoints: number;
             label?: string;
+            tokenAddress?: string;
         }>;
         chain?: string;
     }): Promise<any>;
@@ -134,11 +150,16 @@ export declare function createClient(config: ApinowConfig): {
     }): Promise<any>;
     /**
      * Create a markup workflow wrapping an existing endpoint.
+     * Optionally allocate a portion of the markup to a token buy split.
      */
     factoryMarkup(opts: {
         endpointId: string;
         markupPercent?: number;
         workflowName?: string;
+        tokenBuyPercent?: number;
+        tokenBuyRecipient?: string;
+        tokenBuyCA?: string;
+        markupRecipient?: string;
     }): Promise<any>;
     /**
      * Test-call an endpoint without payment (free, server-side LLM call).
@@ -149,6 +170,27 @@ export declare function createClient(config: ApinowConfig): {
         input?: any;
         saveExample?: boolean;
     }): Promise<any>;
+    /**
+     * Discover the x402 price for any external URL without executing it.
+     * Free — no payment required.
+     *
+     * @example
+     * const price = await apinow.discoverPrice('https://stablesocial.dev/api/tiktok/profile');
+     * console.log(price.totalPrice); // "$0.070000"
+     */
+    discoverPrice(url: string, method?: string): Promise<PriceDiscovery>;
+    /**
+     * Call any external x402 endpoint through the APINow proxy.
+     * Handles payment automatically: you pay APINow (upstream price + proxy fee),
+     * and APINow pays the upstream service with its server wallet.
+     *
+     * @example
+     * const data = await apinow.callExternal('https://stablesocial.dev/api/tiktok/profile', {
+     *   method: 'POST',
+     *   body: { handle: 'someuser' },
+     * });
+     */
+    callExternal(url: string, opts?: ExternalCallOptions): Promise<any>;
     /**
      * The underlying x402-wrapped fetch, for advanced use.
      */

package/dist/index.js

@@ -241,6 +241,7 @@ export function createClient(config) {
         },
         /**
          * Create a markup workflow wrapping an existing endpoint.
+         * Optionally allocate a portion of the markup to a token buy split.
          */
         async factoryMarkup(opts) {
             const res = await fetch(`${baseUrl}/api/user-factory/markup`, {
@@ -269,6 +270,48 @@ export function createClient(config) {
             }
             return res.json();
         },
+        // ─── External x402 Proxy ───
+        /**
+         * Discover the x402 price for any external URL without executing it.
+         * Free — no payment required.
+         *
+         * @example
+         * const price = await apinow.discoverPrice('https://stablesocial.dev/api/tiktok/profile');
+         * console.log(price.totalPrice); // "$0.070000"
+         */
+        async discoverPrice(url, method) {
+            const params = new URLSearchParams({ url });
+            if (method)
+                params.set('method', method);
+            const res = await fetch(`${baseUrl}/api/x402-proxy?${params}`);
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`Discovery failed: ${res.status} ${text}`);
+            }
+            return res.json();
+        },
+        /**
+         * Call any external x402 endpoint through the APINow proxy.
+         * Handles payment automatically: you pay APINow (upstream price + proxy fee),
+         * and APINow pays the upstream service with its server wallet.
+         *
+         * @example
+         * const data = await apinow.callExternal('https://stablesocial.dev/api/tiktok/profile', {
+         *   method: 'POST',
+         *   body: { handle: 'someuser' },
+         * });
+         */
+        async callExternal(url, opts = {}) {
+            return this.call('/api/x402-proxy', {
+                method: 'POST',
+                body: {
+                    url,
+                    method: opts.method || 'POST',
+                    body: opts.body,
+                    headers: opts.headers,
+                },
+            });
+        },
         /**
          * The underlying x402-wrapped fetch, for advanced use.
          */

package/package.json

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