apinow-sdk 0.21.0 → 0.22.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.21.0');
+    .version('0.22.0');
 // ─── Helpers ───
 function getPrivateKey(opts) {
     const raw = opts.key || process.env.APINOW_WALLET_PKEY || process.env.PRIVATE_KEY;
@@ -637,9 +637,9 @@ program
 // ─── factory-create ───
 program
     .command('factory-create')
-    .description('Create an LLM endpoint via user-factory')
-    .requiredOption('--name <name>', 'Endpoint name')
-    .requiredOption('--prompt <prompt>', 'System prompt for the LLM')
+    .description('Create an LLM endpoint via user-factory (flags or --from-json)')
+    .option('--name <name>', 'Endpoint name')
+    .option('--prompt <prompt>', 'System prompt for the LLM')
     .option('--namespace <ns>', 'Namespace (defaults to u-<wallet>)')
     .option('--description <desc>', 'Endpoint description')
     .option('--model <model>', 'LLM model', 'google/gemini-2.0-flash-001')
@@ -647,16 +647,54 @@ program
     .option('--recipient <wallet>', 'Payment recipient wallet')
     .option('--input-params <json>', 'Input params JSON array')
     .option('--output-params <json>', 'Output params JSON array')
+    .option('--from-json <path>', 'JSON file with config (use "-" for stdin). Fields: name, prompt, description, model, suggestedPrice, inputParams, outputParams')
     .option('-k, --key <privateKey>', 'Wallet private key')
     .action(async (opts) => {
     try {
         const { address } = getWallet(opts);
-        const body = {
-            name: opts.name,
-            prompt: opts.prompt,
-            model: opts.model,
-            usdcPrice: opts.price,
-        };
+        let body;
+        if (opts.fromJson) {
+            const { readFileSync } = await import('fs');
+            let raw;
+            if (opts.fromJson === '-') {
+                const chunks = [];
+                for await (const chunk of process.stdin)
+                    chunks.push(chunk);
+                raw = Buffer.concat(chunks).toString('utf8');
+            }
+            else {
+                raw = readFileSync(opts.fromJson, 'utf8');
+            }
+            const json = JSON.parse(raw);
+            body = {
+                name: json.name,
+                prompt: json.prompt,
+                model: json.model || opts.model,
+                usdcPrice: json.suggestedPrice || json.usdcPrice || opts.price,
+            };
+            if (json.namespace)
+                body.namespace = json.namespace;
+            if (json.description)
+                body.description = json.description;
+            if (json.recipientWallet)
+                body.recipientWallet = json.recipientWallet;
+            if (json.inputParams)
+                body.inputParams = json.inputParams;
+            if (json.outputParams)
+                body.outputParams = json.outputParams;
+        }
+        else {
+            body = {
+                name: opts.name,
+                prompt: opts.prompt,
+                model: opts.model,
+                usdcPrice: opts.price,
+            };
+        }
+        if (!body.name || !body.prompt) {
+            console.error('Error: --name and --prompt are required (or provide --from-json)');
+            process.exit(1);
+        }
         if (opts.namespace)
             body.namespace = opts.namespace;
         if (opts.description)
@@ -667,7 +705,7 @@ program
             body.inputParams = JSON.parse(opts.inputParams);
         if (opts.outputParams)
             body.outputParams = JSON.parse(opts.outputParams);
-        console.error(`Creating endpoint "${opts.name}"…`);
+        console.error(`Creating endpoint "${body.name}"…`);
         const data = await fetchJson(`${API_BASE}/api/user-factory`, {
             method: 'POST',
             headers: walletHeaders(address),
@@ -765,4 +803,126 @@ program
         process.exit(1);
     }
 });
+// ─── factory-pipeline ───
+program
+    .command('factory-pipeline <idea>')
+    .description('Full pipeline: generate → create → test → optional markup workflow')
+    .option('--markup <percent>', 'Markup percent (creates a markup workflow after endpoint creation)')
+    .option('--markup-recipient <wallet>', 'Wallet to receive markup USDC')
+    .option('--token-buy-percent <percent>', 'Percent of base price for token buy')
+    .option('--token-buy-recipient <wallet>', 'Wallet to receive token buy portion')
+    .option('--token-buy-ca <address>', 'Token contract address for buy (default: $APINOW)')
+    .option('--recipient <wallet>', 'Endpoint payment recipient wallet')
+    .option('--price <usdc>', 'Override suggested USDC price')
+    .option('--model <model>', 'Override suggested model')
+    .option('--dry-run', 'Generate and print config without creating')
+    .option('-k, --key <privateKey>', 'Wallet private key')
+    .action(async (idea, opts) => {
+    try {
+        const { address } = getWallet(opts);
+        // Step 1: Generate
+        console.error('Step 1/4: Generating endpoint config from idea…');
+        const draft = await fetchJson(`${API_BASE}/api/user-factory/generate`, {
+            method: 'POST',
+            headers: walletHeaders(address),
+            body: JSON.stringify({ idea }),
+        });
+        console.error(`  → ${draft.name}: ${draft.description}`);
+        console.error(`  → Model: ${draft.model}, Price: $${draft.suggestedPrice}`);
+        console.error(`  → Input params: ${(draft.inputParams || []).map((p) => p.name).join(', ') || '(none)'}`);
+        console.error(`  → Output params: ${(draft.outputParams || []).map((p) => p.name).join(', ') || '(none)'}`);
+        if (opts.dryRun) {
+            console.log(JSON.stringify(draft, null, 2));
+            return;
+        }
+        // Step 2: Create
+        console.error('\nStep 2/4: Creating endpoint…');
+        const createBody = {
+            name: draft.name,
+            prompt: draft.prompt,
+            description: draft.description,
+            model: opts.model || draft.model || 'google/gemini-2.0-flash-001',
+            usdcPrice: opts.price || draft.suggestedPrice || '0.01',
+            inputParams: draft.inputParams,
+            outputParams: draft.outputParams,
+        };
+        if (opts.recipient)
+            createBody.recipientWallet = opts.recipient;
+        const createData = await fetchJson(`${API_BASE}/api/user-factory`, {
+            method: 'POST',
+            headers: walletHeaders(address),
+            body: JSON.stringify(createBody),
+        });
+        const ep = createData.endpoint;
+        console.error(`  → Created: ${ep.namespace}/${ep.endpointName}`);
+        // Step 3: Test
+        console.error('\nStep 3/4: Running test call…');
+        const testInput = draft.exampleInput || { prompt: 'test' };
+        const testData = await fetchJson(`${API_BASE}/api/user-factory/test-call`, {
+            method: 'POST',
+            headers: walletHeaders(address),
+            body: JSON.stringify({
+                namespace: ep.namespace,
+                endpointName: ep.endpointName,
+                input: testInput,
+                saveExample: true,
+            }),
+        });
+        console.error('  → Test passed, example saved');
+        // Step 4: Markup (optional)
+        let workflow = null;
+        if (opts.markup) {
+            console.error(`\nStep 4/4: Creating markup workflow (${opts.markup}%)…`);
+            const markupBody = {
+                endpointId: ep.id,
+                markupPercent: Number(opts.markup),
+            };
+            if (opts.markupRecipient)
+                markupBody.markupRecipient = opts.markupRecipient;
+            if (opts.tokenBuyPercent)
+                markupBody.tokenBuyPercent = Number(opts.tokenBuyPercent);
+            if (opts.tokenBuyRecipient)
+                markupBody.tokenBuyRecipient = opts.tokenBuyRecipient;
+            if (opts.tokenBuyCa)
+                markupBody.tokenBuyCA = opts.tokenBuyCa;
+            const markupData = await fetchJson(`${API_BASE}/api/user-factory/markup`, {
+                method: 'POST',
+                headers: walletHeaders(address),
+                body: JSON.stringify(markupBody),
+            });
+            workflow = markupData.workflow;
+            console.error(`  → Workflow: ${workflow.name} ($${workflow.totalPrice} USDC)`);
+        }
+        else {
+            console.error('\nStep 4/4: Skipped (no --markup flag)');
+        }
+        // Final output
+        const result = {
+            endpoint: {
+                id: ep.id,
+                namespace: ep.namespace,
+                name: ep.endpointName,
+                model: ep.model,
+                price: ep.price,
+                tryUrl: `https://apinow.fun${ep.tryUrl}`,
+                apiUrl: `https://apinow.fun${ep.apiUrl}`,
+            },
+            testOutput: testData.output,
+        };
+        if (workflow) {
+            result.workflow = {
+                id: workflow.workflowId,
+                name: workflow.name,
+                totalPrice: workflow.totalPrice,
+                markupPercent: workflow.markupPercent,
+                viewUrl: `https://apinow.fun${workflow.viewUrl}`,
+            };
+        }
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/index.d.ts

@@ -171,6 +171,37 @@ export declare function createClient(config: ApinowConfig): {
         input?: any;
         saveExample?: boolean;
     }): Promise<any>;
+    /**
+     * Full pipeline: generate config from idea → create endpoint → test → optional markup workflow.
+     * Returns { draft, endpoint, testOutput, workflow? }.
+     *
+     * @example
+     * const result = await apinow.factoryPipeline('Score startup pitches on 8 criteria', {
+     *   recipientWallet: '0x...',
+     *   markup: { markupPercent: 30, markupRecipient: '0x...' },
+     * });
+     * console.log(result.endpoint.namespace + '/' + result.endpoint.endpointName);
+     * console.log(result.workflow?.viewUrl);
+     */
+    factoryPipeline(idea: string, opts?: {
+        recipientWallet?: string;
+        model?: string;
+        usdcPrice?: string;
+        markup?: {
+            markupPercent?: number;
+            markupAmount?: number;
+            markupRecipient?: string;
+            tokenBuyPercent?: number;
+            tokenBuyRecipient?: string;
+            tokenBuyCA?: string;
+        };
+        skipTest?: boolean;
+    }): Promise<{
+        draft: any;
+        endpoint: any;
+        testOutput: any;
+        workflow: any;
+    }>;
     /**
      * Discover the x402 price for any external URL without executing it.
      * Free — no payment required.

package/dist/index.js

@@ -294,6 +294,55 @@ export function createClient(config) {
             }
             return res.json();
         },
+        // ─── Factory Pipeline ───
+        /**
+         * Full pipeline: generate config from idea → create endpoint → test → optional markup workflow.
+         * Returns { draft, endpoint, testOutput, workflow? }.
+         *
+         * @example
+         * const result = await apinow.factoryPipeline('Score startup pitches on 8 criteria', {
+         *   recipientWallet: '0x...',
+         *   markup: { markupPercent: 30, markupRecipient: '0x...' },
+         * });
+         * console.log(result.endpoint.namespace + '/' + result.endpoint.endpointName);
+         * console.log(result.workflow?.viewUrl);
+         */
+        async factoryPipeline(idea, opts = {}) {
+            const draft = await this.factoryGenerate(idea);
+            const createConfig = {
+                name: draft.name,
+                prompt: draft.prompt,
+                description: draft.description,
+                model: opts.model || draft.model || 'google/gemini-2.0-flash-001',
+                usdcPrice: opts.usdcPrice || draft.suggestedPrice || '0.01',
+                inputParams: draft.inputParams,
+                outputParams: draft.outputParams,
+            };
+            if (opts.recipientWallet)
+                createConfig.recipientWallet = opts.recipientWallet;
+            const createData = await this.factoryCreate(createConfig);
+            const endpoint = createData.endpoint;
+            let testOutput = null;
+            if (!opts.skipTest) {
+                const testInput = draft.exampleInput || { prompt: 'test' };
+                const testData = await this.factoryTestCall({
+                    namespace: endpoint.namespace,
+                    endpointName: endpoint.endpointName,
+                    input: testInput,
+                    saveExample: true,
+                });
+                testOutput = testData.output;
+            }
+            let workflow = null;
+            if (opts.markup) {
+                const markupData = await this.factoryMarkup({
+                    endpointId: endpoint.id,
+                    ...opts.markup,
+                });
+                workflow = markupData.workflow;
+            }
+            return { draft, endpoint, testOutput, workflow };
+        },
         // ─── External x402 Proxy ───
         /**
          * Discover the x402 price for any external URL without executing it.
@@ -326,14 +375,13 @@ export function createClient(config) {
          * });
          */
         async callExternal(url, opts = {}) {
-            return this.call('/api/x402-proxy', {
+            const params = new URLSearchParams({ url });
+            if (opts.method)
+                params.set('method', opts.method);
+            return this.call(`/api/x402-proxy?${params}`, {
                 method: 'POST',
-                body: {
-                    url,
-                    method: opts.method || 'POST',
-                    body: opts.body,
-                    headers: opts.headers,
-                },
+                body: opts.body,
+                headers: opts.headers,
             });
         },
         /**

package/package.json

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