@trawlme/cli 1.15.0 → 1.16.0

package/README.md

@@ -117,9 +117,15 @@ TRAWL_TELEMETRY=0 trawl scraps list
 | Variable           | Description                                                       |
 |--------------------|-------------------------------------------------------------------|
 | `TRAWL_TOKEN`      | JWT token — bypasses login prompt, useful for CI/CD               |
-| `TRAWL_API_URL`    | Override the default API URL (`https://api.trawl.me`)             |
+| `TRAWL_API_URL`    | Override the API base URL for the session (takes precedence over `trawl login --url`) |
 | `TRAWL_TELEMETRY`  | Set to `0` to disable telemetry for the current session           |
 
+Session override (no `trawl login` mutation, ideal for CI/QA against another env):
+
+```bash
+TRAWL_API_URL=https://dev.trawl.me TRAWL_TOKEN=<jwt> trawl scraps list --json
+```
+
 ## API documentation
 
 The Trawl API is documented at [trawl.me/api/spec.json](https://trawl.me/api/spec.json) (OpenAPI 3).

package/dist/commands/login.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import config from '../lib/config.js';
+import config, { getApiUrl } from '../lib/config.js';
 import { api } from '../lib/api.js';
 import { requireJwt, requireUrl } from '../lib/validate.js';
 import { promptPassword } from '../lib/prompt.js';
@@ -30,7 +30,7 @@ export const login = new Command('login')
     if (envToken) {
         config.set('token', requireJwt(envToken, 'TRAWL_TOKEN'));
         console.log(chalk.green('✓ Logged in'));
-        console.log(chalk.dim(`  API: ${config.get('apiUrl')}`));
+        console.log(chalk.dim(`  API: ${getApiUrl()}`));
         console.log(chalk.dim(`  Config: ${config.path}`));
         return;
     }
@@ -38,7 +38,7 @@ export const login = new Command('login')
     if (opts.token) {
         config.set('token', requireJwt(opts.token, '--token'));
         console.log(chalk.green('✓ Logged in'));
-        console.log(chalk.dim(`  API: ${config.get('apiUrl')}`));
+        console.log(chalk.dim(`  API: ${getApiUrl()}`));
         console.log(chalk.dim(`  Config: ${config.path}`));
         return;
     }
@@ -63,7 +63,7 @@ export const login = new Command('login')
     const token = requireJwt(raw, 'token');
     config.set('token', token);
     console.log(chalk.green(`✓ Logged in as ${email}`));
-    console.log(chalk.dim(`  API: ${config.get('apiUrl')}`));
+    console.log(chalk.dim(`  API: ${getApiUrl()}`));
     console.log(chalk.dim(`  Config: ${config.path}`));
 });
 export const logout = new Command('logout')

package/dist/lib/api.js

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, resolve } from 'node:path';
-import config from './config.js';
+import config, { getApiUrl } from './config.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '../../package.json'), 'utf8'));
 const USER_AGENT = `@trawlme/cli/${pkg.version}`;
@@ -60,7 +60,7 @@ async function request(path, options = {}) {
     const token = config.get('token');
     if (!token)
         throw new Error('Not logged in. Run: trawl login');
-    const url = `${config.get('apiUrl')}${path}`;
+    const url = `${getApiUrl()}${path}`;
     const res = await fetch(url, {
         ...options,
         headers: {
@@ -90,7 +90,7 @@ async function upload(path, formData) {
     const token = config.get('token');
     if (!token)
         throw new Error('Not logged in. Run: trawl login');
-    const url = `${config.get('apiUrl')}${path}`;
+    const url = `${getApiUrl()}${path}`;
     // Do NOT set Content-Type — fetch sets it automatically with the correct multipart boundary
     const res = await fetch(url, {
         method: 'POST',
@@ -117,7 +117,7 @@ async function upload(path, formData) {
     }
 }
 async function publicPost(path, body) {
-    const url = `${config.get('apiUrl')}${path}`;
+    const url = `${getApiUrl()}${path}`;
     const res = await fetch(url, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json', 'User-Agent': USER_AGENT },
@@ -137,7 +137,7 @@ async function getText(path) {
     const token = config.get('token');
     if (!token)
         throw new Error('Not logged in. Run: trawl login');
-    const url = `${config.get('apiUrl')}${path}`;
+    const url = `${getApiUrl()}${path}`;
     const res = await fetch(url, {
         headers: {
             'User-Agent': USER_AGENT,
@@ -165,7 +165,7 @@ export const api = {
         const token = config.get('token');
         if (!token)
             throw new Error('Not logged in. Run: trawl login');
-        const url = `${config.get('apiUrl')}${path}`;
+        const url = `${getApiUrl()}${path}`;
         const res = await fetch(url, {
             headers: {
                 Accept: 'text/event-stream',

package/dist/lib/config.d.ts

@@ -6,4 +6,12 @@ interface TrawlConfig {
     telemetryUserId: string;
 }
 declare const config: Conf<TrawlConfig>;
+/**
+ * Resolve the effective API base URL.
+ * Precedence: TRAWL_API_URL env > stored `trawl login --url` > default.
+ * Mirrors the TRAWL_TOKEN / TRAWL_TELEMETRY session-override pattern so scripts
+ * (e.g. infra /trawl-prod-qa against https://dev.trawl.me) can retarget the CLI
+ * without mutating the operator's persisted config. (#56)
+ */
+export declare function getApiUrl(): string;
 export default config;

package/dist/lib/config.js

@@ -8,4 +8,15 @@ const config = new Conf({
         telemetryUserId: '',
     },
 });
+/**
+ * Resolve the effective API base URL.
+ * Precedence: TRAWL_API_URL env > stored `trawl login --url` > default.
+ * Mirrors the TRAWL_TOKEN / TRAWL_TELEMETRY session-override pattern so scripts
+ * (e.g. infra /trawl-prod-qa against https://dev.trawl.me) can retarget the CLI
+ * without mutating the operator's persisted config. (#56)
+ */
+export function getApiUrl() {
+    const override = process.env['TRAWL_API_URL']?.trim();
+    return override ? override : config.get('apiUrl');
+}
 export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trawlme/cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Trawl CLI — manage scraps from the terminal",
   "type": "module",
   "bin": {