apinow-sdk 0.19.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')

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;
@@ -155,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

@@ -270,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.19.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",