crewpay-rest 0.2.0 → 0.2.1

package/README.md

@@ -2,8 +2,8 @@
 
 Shared CrewPay REST client for framework plugins.
 
-- Dry-run returns `dryRunId` + `approvalUrl` (no approve secret)
+- Approval is optional. Operators can require human approval per key. Dry-run returns `dryRunId` + `approvalUrl` when used
 - Operator opens `approvalUrl` and wallet-signs
-- `launch` / `wireFees` require approved `dryRunId`
+- `launch` / `wireFees`: dryRunId optional unless requireApproval
 
 Prefer MCP: `npx -y crewpay-mcp@1.2.3`

package/dist/client.d.ts

@@ -2,9 +2,9 @@
  * Minimal CrewPay REST client for framework plugins.
  * Keys from env only — never accept private keys as function arguments.
  *
- * Spend gate: POST /api/agent/launch/dry-run returns dryRunId + approvalUrl
- * (no approve secret). Operator opens approvalUrl and wallet-signs.
- * Launch/wire require dryRunId after approval. Image content is bound by sha256.
+ * Approval is optional. Operators can require human approval per key.
+ * When requireApproval is off (default), launch/wire work with the API key alone.
+ * dryRunId is optional; when sent it is validated. Image content is bound by sha256 when dry-running.
  */
 export declare const DEFAULT_API_URL = "https://api.crewpay.dev";
 export type CrewPayEnv = {
@@ -30,8 +30,8 @@ export declare class CrewPayClient {
     autohire(body: Record<string, unknown>): Promise<unknown>;
     /** Server dry-run — returns plan + dryRunId + approvalUrl (no approve secret). */
     dryRun(body: Record<string, unknown>): Promise<unknown>;
-    launch(body: Record<string, unknown>, opts: {
-        dryRunId: string;
+    launch(body: Record<string, unknown>, opts?: {
+        dryRunId?: string;
     }): Promise<unknown>;
     wireFees(body: {
         mint: string;
@@ -39,8 +39,8 @@ export declare class CrewPayClient {
         crew?: unknown[];
         name?: string;
         ticker?: string;
-    }, opts: {
-        dryRunId: string;
+    }, opts?: {
+        dryRunId?: string;
     }): Promise<unknown>;
     crank(body: {
         mint: string;

package/dist/client.js

@@ -2,9 +2,9 @@
  * Minimal CrewPay REST client for framework plugins.
  * Keys from env only — never accept private keys as function arguments.
  *
- * Spend gate: POST /api/agent/launch/dry-run returns dryRunId + approvalUrl
- * (no approve secret). Operator opens approvalUrl and wallet-signs.
- * Launch/wire require dryRunId after approval. Image content is bound by sha256.
+ * Approval is optional. Operators can require human approval per key.
+ * When requireApproval is off (default), launch/wire work with the API key alone.
+ * dryRunId is optional; when sent it is validated. Image content is bound by sha256 when dry-running.
  */
 export const DEFAULT_API_URL = 'https://api.crewpay.dev';
 export function loadCrewPayEnv(overrides = {}) {
@@ -83,27 +83,23 @@ export class CrewPayClient {
         });
     }
     launch(body, opts) {
-        const dryRunId = String(opts.dryRunId || '').trim();
-        if (!dryRunId) {
-            throw new Error('Launch blocked: dryRunId required — dry-run, operator wallet-approves on approvalUrl, then launch');
-        }
+        const dryRunId = String(opts?.dryRunId || '').trim();
+        const payload = dryRunId ? { ...body, dryRunId } : { ...body };
         return this.fetch('/api/agent/launch', {
             method: 'POST',
             auth: true,
             launcher: true,
-            body: JSON.stringify({ ...body, dryRunId }),
+            body: JSON.stringify(payload),
         });
     }
     wireFees(body, opts) {
-        const dryRunId = String(opts.dryRunId || '').trim();
-        if (!dryRunId) {
-            throw new Error('Wire-fees blocked: dryRunId required — dry-run with intent=wire-fees, wallet-approve, then wire');
-        }
+        const dryRunId = String(opts?.dryRunId || '').trim();
+        const payload = dryRunId ? { ...body, dryRunId } : { ...body };
         return this.fetch('/api/agent/wire-fees', {
             method: 'POST',
             auth: true,
             launcher: true,
-            body: JSON.stringify({ ...body, dryRunId }),
+            body: JSON.stringify(payload),
         });
     }
     crank(body) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "crewpay-rest",
-  "version": "0.2.0",
-  "description": "Shared CrewPay REST client — dry-run + wallet-approved dryRunId for launch/wire. Env keys only.",
+  "version": "0.2.1",
+  "description": "Shared CrewPay REST client \u2014 dry-run + wallet-approved dryRunId for launch/wire. Env keys only.",
   "type": "module",
   "main": "./dist/client.js",
   "types": "./dist/client.d.ts",
@@ -11,7 +11,10 @@
       "import": "./dist/client.js"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "vitest run",
@@ -24,8 +27,12 @@
     "directory": "packages/crewpay-rest"
   },
   "homepage": "https://crewpay.dev/agents",
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=20" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.7.0",