@hasna/connectors 1.4.2 → 1.4.3

package/connectors/velum-data-quality/src/index.ts

@@ -8,7 +8,6 @@ export {
   ChecksApi,
   EventsApi,
   SearchApi,
-  DEFAULT_BASE_URL,
 } from './api';
 
 export {

package/connectors/vercel-api-platform/.env.example

@@ -1,5 +1,5 @@
 # Vercel Api Platform API credentials
 VERCEL_API_PLATFORM_API_KEY=your-api-key-here
 
-# Optional: override API base URL (default https://api.vercelapiplatform.com/v1)
+# Optional: override API base URL (no default - must be configured)
 # VERCEL_API_PLATFORM_BASE_URL=https://api.vercelapiplatform.com/v1

package/connectors/vercel-api-platform/CLAUDE.md

@@ -4,11 +4,11 @@ Guidance for working with the Vercel Api Platform connector.
 
 ## Distinction from connect-vercel
 
-This connector targets **Vercel Api Platform** at `https://api.vercelapiplatform.com/v1` (items, events, search). It is **not** the same as `connect-vercel`, which wraps `api.vercel.com` for deployments and projects.
+This connector targets **Vercel Api Platform** at `configured.example.com/v1` (items, events, search). It is **not** the same as `connect-vercel`, which wraps `api.vercel.com` for deployments and projects.
 
 ## API Reference
 
-- **Base URL**: `https://api.vercelapiplatform.com/v1` (override via profile or `VERCEL_API_PLATFORM_BASE_URL`)
+- **Base URL**: no default (must be configured) (override via profile or `VERCEL_API_PLATFORM_BASE_URL`)
 - **Auth**: Bearer token (`Authorization: Bearer <api_key>`)
 - **Endpoints**:
   - `GET /items` — list items

package/connectors/vercel-api-platform/README.md

@@ -1,6 +1,6 @@
 # @hasna/connect-vercel-api-platform
 
-TypeScript connector and CLI for the [Vercel Api Platform](https://api.vercelapiplatform.com/v1) REST API.
+TypeScript connector and CLI for the [Vercel Api Platform](configured.example.com/v1) REST API.
 
 > **Note:** This is distinct from `@hasna/connect-vercel`, which targets `api.vercel.com` for Vercel deployments.
 
@@ -15,7 +15,7 @@ bun add @hasna/connect-vercel-api-platform
 ```bash
 export VERCEL_API_PLATFORM_API_KEY=your-api-key
 # optional
-export VERCEL_API_PLATFORM_BASE_URL=https://api.vercelapiplatform.com/v1
+export VERCEL_API_PLATFORM_BASE_URL=https://configured.example.com/v1
 ```
 
 Or use the CLI profile/config commands.

package/connectors/vercel-api-platform/src/api/client.test.ts

@@ -1,5 +1,5 @@
 import { describe, test, expect, mock, beforeEach, afterEach } from 'bun:test';
-import { ConnectorClient, DEFAULT_BASE_URL } from './client';
+import { ConnectorClient } from './client';
 import { Connector } from './index';
 import { ConnectorApiError } from '../types';
 
@@ -38,10 +38,9 @@ describe('ConnectorClient', () => {
       expect(client.getBaseUrl()).toBe(TEST_BASE_URL);
     });
 
-    test('uses default base URL when not provided', () => {
-      const client = new ConnectorClient({ apiKey: 'key' });
-      expect(client.getBaseUrl()).toBe(DEFAULT_BASE_URL);
-    });
+      test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new ConnectorClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
 
     test('strips trailing slashes from base URL', () => {
       const client = new ConnectorClient({ apiKey: 'key', baseUrl: 'https://api.example.com/v1///' });
@@ -56,7 +55,7 @@ describe('ConnectorClient', () => {
     });
 
     test('returns *** for short keys', () => {
-      const client = new ConnectorClient({ apiKey: 'short' });
+      const client = new ConnectorClient({ apiKey: 'short', baseUrl: 'https://configured.example.com/v1' });
       expect(client.getApiKeyPreview()).toBe('***');
     });
   });
@@ -198,10 +197,32 @@ describe('Connector API modules', () => {
   test('raw.request uses configured base URL override', async () => {
     const connector = new Connector({
       apiKey: 'key',
+      baseUrl: 'https://configured.example.com/v1',
+      baseUrl: 'https://configured.example.com/v1',
       baseUrl: 'https://override.example.com/v1',
     });
     await connector.raw.request({ path: '/items', method: 'GET' });
     const [url] = getFetchMock().mock.calls[0];
     expect(url).toBe('https://override.example.com/v1/items');
   });
+
+  test('sends the API key only to the configured base URL', async () => {
+    const recorded: string[] = [];
+    globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
+      recorded.push(typeof input === 'string' ? input : input.toString());
+      return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        headers: new Headers({ 'content-type': 'application/json' }),
+        async text() { return JSON.stringify({ ok: true }); },
+        async json() { return { ok: true }; },
+      } as Response;
+    }) as typeof fetch;
+    const client = new ConnectorClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
+    await client.request('/ping');
+    expect(recorded).toHaveLength(1);
+    expect(recorded[0].startsWith('https://configured.example.com/v1/')).toBe(true);
+    expect(recorded[0]).not.toContain('api.vercelapiplatform.com');
+  });
 });

package/connectors/vercel-api-platform/src/api/client.ts

@@ -1,8 +1,6 @@
 import type { ConnectorConfig } from '../types';
 import { ConnectorApiError, parseApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.vercelapiplatform.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
   params?: Record<string, string | number | boolean | undefined>;
@@ -22,7 +20,10 @@ export class ConnectorClient {
       throw new Error('API key, token, or accessToken is required');
     }
     this.apiKey = key;
-    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
+    if (!config.baseUrl) {
+      throw new Error('baseUrl is required: no default endpoint is configured; set baseUrl (profile, config, or the connector BASE_URL environment variable)');
+    }
+    this.baseUrl = config.baseUrl.replace(/\/+$/, '');
   }
 
   getBaseUrl(): string {

package/connectors/vercel-api-platform/src/api/index.ts

@@ -41,7 +41,7 @@ export class Connector {
   }
 }
 
-export { ConnectorClient, DEFAULT_BASE_URL } from './client';
+export { ConnectorClient } from './client';
 export { ItemsApi } from './items';
 export { EventsApi } from './events';
 export { SearchApi } from './search';

package/connectors/vercel-api-platform/src/cli/index.ts

@@ -140,7 +140,7 @@ profileCmd.command('show [name]').description('Show profile configuration').acti
   const active = getCurrentProfile();
   console.log(chalk.bold(`Profile: ${profileName}${profileName === active ? chalk.green(' (active)') : ''}`));
   info(`API Key: ${config.apiKey ? `${config.apiKey.substring(0, 8)}...` : chalk.gray('not set')}`);
-  info(`Base URL: ${config.baseUrl || chalk.gray('default (https://api.vercelapiplatform.com/v1)')}`);
+  info(`Base URL: ${config.baseUrl || chalk.gray('none configured')}`);
 });
 
 const configCmd = program.command('config').description('Manage CLI configuration');
@@ -162,7 +162,7 @@ configCmd.command('show').description('Show current configuration').action(() =>
   console.log(chalk.bold(`Active Profile: ${profileName}`));
   info(`Config directory: ${getConfigDir()}`);
   info(`API Key: ${apiKey ? `${apiKey.substring(0, 8)}...` : chalk.gray('not set')}`);
-  info(`Base URL: ${baseUrl || chalk.gray('default (https://api.vercelapiplatform.com/v1)')}`);
+  info(`Base URL: ${baseUrl || chalk.gray('none configured')}`);
 });
 
 configCmd.command('clear').description('Clear configuration for active profile').action(() => {

package/connectors/vercel-api-platform/src/index.ts

@@ -9,7 +9,6 @@ export {
   EventsApi,
   SearchApi,
   RawApi,
-  DEFAULT_BASE_URL,
 } from './api';
 
 export {

package/connectors/veriphone/README.md

@@ -21,7 +21,7 @@ bun install
 Set your API key via environment variable or CLI profile:
 
 ```bash
-export VERIPHONE_API_KEY=your-api-key-here
+export VERIPHONE_API_KEY=<your-api-key>
 # or
 bun run dev config set-key your-api-key-here
 ```
@@ -35,7 +35,7 @@ Get an API key at [veriphone.io](https://veriphone.io).
 bun run dev verify "+4915123577723"
 
 # With default country hint
-bun run dev verify "015123577723" --default-country DE
+bun run dev verify "0151-23577723" --default-country DE
 
 # Use POST method
 bun run dev verify "+14155552671" --method post

package/connectors/wave-accounting/CLAUDE.md

@@ -29,7 +29,7 @@ bun test
 ## Authentication
 
 - **Bearer token (dev):** Full-access token from Wave developer portal
-- **OAuth2 (production):** Scopes per https://developer.waveapps.com/hc/en-us/articles/360032818132-OAuth-Scopes
+- **OAuth2 (production):** Scopes per the Wave OAuth scopes documentation (developer.waveapps.com)
 
 Auth type: `oauth` / `bearer`
 

package/connectors/wave-accounting/src/utils/auth.ts

@@ -6,7 +6,7 @@ const DEFAULT_AUTH_URL = 'https://api.waveapps.com/oauth2/authorize/';
 const DEFAULT_TOKEN_URL = 'https://api.waveapps.com/oauth2/token/';
 
 // Wave OAuth scopes for accounting/invoicing operations
-// https://developer.waveapps.com/hc/en-us/articles/360032818132-OAuth-Scopes
+// (see developer.waveapps.com OAuth scopes documentation)
 const DEFAULT_SCOPES = [
   'business:read',
   'invoice:read',

package/connectors/weaviate-api-platform/CLAUDE.md

@@ -23,7 +23,7 @@ Bearer token via `Authorization: Bearer <api_key>` header.
 ## Base URL
 
 ```
-https://api.weaviateapiplatform.com/v1
+configured.example.com/v1
 ```
 
 Override with profile `baseUrl` or `WEAVIATE_API_PLATFORM_BASE_URL`.

package/connectors/weaviate-api-platform/src/api/client.test.ts

@@ -1,5 +1,6 @@
 import { afterEach, describe, expect, test } from 'bun:test';
-import { Connector, DEFAULT_BASE_URL } from './index';
+import { ConnectorClient } from './client';
+import { Connector } from './index';
 
 const realFetch = globalThis.fetch;
 
@@ -44,25 +45,25 @@ afterEach(() => {
 describe('WeaviateApiPlatform client', () => {
   test('uses bearer auth and default base URL for listItems', async () => {
     const recorded = installFetch();
-    const client = new Connector({ apiKey: 'test-api-key' });
+    const client = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     await client.listItems();
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/items`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/items`);
     expect(recorded[0].method).toBe('GET');
     expect(recorded[0].headers.authorization || recorded[0].headers.Authorization).toBe('Bearer test-api-key');
   });
 
   test('encodes item IDs in getItem path', async () => {
     const recorded = installFetch();
-    const client = new Connector({ apiKey: 'test-api-key' });
+    const client = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     await client.getItem('item/with/slash');
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/items/${encodeURIComponent('item/with/slash')}`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/items/${encodeURIComponent('item/with/slash')}`);
   });
 
   test('posts search body to /search', async () => {
     const recorded = installFetch();
-    const client = new Connector({ apiKey: 'test-api-key' });
+    const client = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     await client.search({ query: 'hello', limit: 5 });
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/search`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/search`);
     expect(recorded[0].method).toBe('POST');
     expect(recorded[0].body).toBe(JSON.stringify({ query: 'hello', limit: 5 }));
   });
@@ -80,4 +81,28 @@ describe('WeaviateApiPlatform client', () => {
   test('requires API key', () => {
     expect(() => new Connector({})).toThrow('API key is required');
   });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new ConnectorClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
+
+  test('sends the API key only to the configured base URL', async () => {
+    const recorded: string[] = [];
+    globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
+      recorded.push(typeof input === 'string' ? input : input.toString());
+      return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        headers: new Headers({ 'content-type': 'application/json' }),
+        async text() { return JSON.stringify({ ok: true }); },
+        async json() { return { ok: true }; },
+      } as Response;
+    }) as typeof fetch;
+    const client = new ConnectorClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
+    await client.request('/ping');
+    expect(recorded).toHaveLength(1);
+    expect(recorded[0].startsWith('https://configured.example.com/v1/')).toBe(true);
+    expect(recorded[0]).not.toContain('api.weaviateapiplatform.com');
+  });
 });

package/connectors/weaviate-api-platform/src/api/client.ts

@@ -1,8 +1,6 @@
 import type { ConnectorConfig, RawRequestOptions } from '../types';
 import { ConnectorApiError, parseApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.weaviateapiplatform.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: Record<string, string | number | boolean | undefined>;
@@ -22,7 +20,10 @@ export class ConnectorClient {
       throw new Error('Weaviate API Platform API key is required');
     }
     this.apiKey = key;
-    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
+    if (!config.baseUrl) {
+      throw new Error('baseUrl is required: no default endpoint is configured; set baseUrl (profile, config, or the connector BASE_URL environment variable)');
+    }
+    this.baseUrl = config.baseUrl.replace(/\/$/, '');
   }
 
   getBaseUrl(): string {

package/connectors/weaviate-api-platform/src/api/index.ts

@@ -56,4 +56,4 @@ export class Connector {
   }
 }
 
-export { ConnectorClient, DEFAULT_BASE_URL } from './client';
+export { ConnectorClient } from './client';

package/connectors/weaviate-api-platform/src/cli/index.ts

@@ -166,7 +166,7 @@ configCmd.command('show').description('Show current configuration').action(() =>
   console.log(chalk.bold(`Active Profile: ${profileName}`));
   info(`Config directory: ${getConfigDir()}`);
   info(`API Key: ${apiKey ? `${apiKey.substring(0, 8)}...` : chalk.gray('not set')}`);
-  info(`Base URL: ${baseUrl || chalk.gray('https://api.weaviateapiplatform.com/v1 (default)')}`);
+  info(`Base URL: ${baseUrl || chalk.gray('none configured')}`);
 });
 
 configCmd.command('clear').description('Clear configuration for active profile').action(() => {

package/connectors/weaviate-api-platform/src/index.ts

@@ -1,6 +1,6 @@
 // Weaviate API Platform Connector
 
-export { Connector, ConnectorClient, DEFAULT_BASE_URL } from './api';
+export { Connector, ConnectorClient } from './api';
 export * from './types';
 
 export {

package/connectors/workflow-trigger/.env.example

@@ -1,5 +1,5 @@
 # WorkflowTrigger API credentials (placeholders only)
 WORKFLOW_TRIGGER_API_KEY=your-api-key-here
 
-# Optional: override API base URL (default: https://api.workflow-trigger.com/v1)
+# Optional: override API base URL (no default - must be configured)
 # WORKFLOW_TRIGGER_BASE_URL=https://api.workflow-trigger.com/v1

package/connectors/workflow-trigger/CLAUDE.md

@@ -56,7 +56,7 @@ src/
 
 ## API Details
 
-- **Base URL**: `https://api.workflow-trigger.com/v1` (override with `WORKFLOW_TRIGGER_BASE_URL`)
+- **Base URL**: no default (must be configured) (override with `WORKFLOW_TRIGGER_BASE_URL`)
 - **Auth**: Bearer token (`Authorization: Bearer <api_key>`)
 - **Endpoints**:
   - `GET /triggers` - List triggers

package/connectors/workflow-trigger/README.md

@@ -13,7 +13,7 @@ bun install
 ```bash
 export WORKFLOW_TRIGGER_API_KEY=your-api-key
 # optional:
-export WORKFLOW_TRIGGER_BASE_URL=https://api.workflow-trigger.com/v1
+export WORKFLOW_TRIGGER_BASE_URL=https://configured.example.com/v1
 ```
 
 Or use the CLI profile:

package/connectors/workflow-trigger/src/api/client.test.ts

@@ -54,22 +54,22 @@ describe('WorkflowTrigger API client', () => {
 
   test('list triggers uses Bearer auth and GET /triggers', async () => {
     const recorded = installFetch(() => ({ data: [] }));
-    const client = new ConnectorClient({ apiKey: 'test-key' });
+    const client = new ConnectorClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
     await client.get('/triggers');
 
     expect(recorded).toHaveLength(1);
-    expect(recorded[0].url).toBe('https://api.workflow-trigger.com/v1/triggers');
+    expect(recorded[0].url).toBe('https://configured.example.com/v1/triggers');
     expect(recorded[0].method).toBe('GET');
     expect(recorded[0].headers.Authorization || recorded[0].headers.authorization).toBe('Bearer test-key');
   });
 
   test('get trigger encodes ID in path', async () => {
     const recorded = installFetch(() => ({ id: 'item-1' }));
-    const connector = new Connector({ apiKey: 'workflow-trigger-key' });
+    const connector = new Connector({ apiKey: 'workflow-trigger-key', baseUrl: 'https://configured.example.com/v1' });
     await connector.triggers.get('item-1');
 
     expect(recorded).toHaveLength(1);
-    expect(recorded[0].url).toBe('https://api.workflow-trigger.com/v1/triggers/item-1');
+    expect(recorded[0].url).toBe('https://configured.example.com/v1/triggers/item-1');
     expect(recorded[0].headers.Authorization || recorded[0].headers.authorization).toBe('Bearer workflow-trigger-key');
   });
 
@@ -86,10 +86,14 @@ describe('WorkflowTrigger API client', () => {
 
   test('search posts to /search', async () => {
     const recorded = installFetch(() => ({ results: [] }));
-    const connector = new Connector({ apiKey: 'key' });
+    const connector = new Connector({ apiKey: 'key', baseUrl: 'https://configured.example.com/v1' });
     await connector.search.search({ query: 'test' });
 
-    expect(recorded[0].url).toBe('https://api.workflow-trigger.com/v1/search');
+    expect(recorded[0].url).toBe('https://configured.example.com/v1/search');
     expect(recorded[0].method).toBe('POST');
   });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new ConnectorClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
 });

package/connectors/workflow-trigger/src/api/client.ts

@@ -2,8 +2,6 @@ import type { ConnectorConfig } from '../types';
 import { ConnectorApiError, parseApiError } from '../types';
 import type { RawRequestParams } from '../types';
 
-const DEFAULT_BASE_URL = 'https://api.workflow-trigger.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: Record<string, string | number | boolean | undefined>;
@@ -23,7 +21,10 @@ export class ConnectorClient {
       throw new Error('WorkflowTrigger API key is required');
     }
     this.apiKey = key;
-    this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    if (!config.baseUrl) {
+      throw new Error('baseUrl is required: no default endpoint is configured; set baseUrl (profile, config, or the connector BASE_URL environment variable)');
+    }
+    this.baseUrl = config.baseUrl;
   }
 
   private buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string {

package/connectors/workflow-trigger/src/cli/index.ts

@@ -204,7 +204,7 @@ configCmd
     console.log(chalk.bold(`Active Profile: ${profileName}`));
     info(`Config directory: ${getConfigDir()}`);
     info(`API Key: ${apiKey ? `${apiKey.substring(0, 8)}...` : chalk.gray('not set')}`);
-    info(`Base URL: ${baseUrl || chalk.gray('default (https://api.workflow-trigger.com/v1)')}`);
+    info(`Base URL: ${baseUrl || chalk.gray('none configured')}`);
   });
 
 configCmd

package/connectors/write-binary-file/CLAUDE.md

@@ -19,7 +19,7 @@ bun run typecheck
 
 API key bearer auth. Set via profile config, `WRITE_BINARY_FILE_API_KEY`, or `--api-key`.
 
-Default base URL: `https://api.write-binary-file.com/v1`
+Default base URL: none (must be configured)
 
 ## API Surface
 

package/connectors/write-binary-file/README.md

@@ -1,6 +1,6 @@
 # connect-write-binary-file
 
-TypeScript connector and CLI for the [Write Binary File](https://api.write-binary-file.com) REST API.
+TypeScript connector and CLI for the [Write Binary File](configured.example.com/v1) REST API.
 
 ## Features
 

package/connectors/write-binary-file/src/api/client.test.ts

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, test } from 'bun:test';
-import { DEFAULT_BASE_URL, WriteBinaryFileClient } from './client';
+import { WriteBinaryFileClient } from './client';
 
 const realFetch = globalThis.fetch;
 
@@ -36,46 +36,50 @@ afterEach(() => {
 describe('WriteBinaryFileClient transport', () => {
   test('listFiles uses bearer auth and default base URL', async () => {
     const recorded = installFetch();
-    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key' });
+    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key', baseUrl: 'https://configured.example.com/v1' });
     await client.listFiles();
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/files`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/files`);
     expect(recorded[0].method).toBe('GET');
     expect(recorded[0].headers.get('Authorization')).toBe('Bearer write-binary-file-key');
   });
 
   test('getFile encodes file id in path', async () => {
     const recorded = installFetch();
-    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key' });
+    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key', baseUrl: 'https://configured.example.com/v1' });
     await client.getFile('item-1');
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/files/item-1`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/files/item-1`);
     expect(recorded[0].headers.get('Authorization')).toBe('Bearer write-binary-file-key');
   });
 
   test('createFile posts JSON body', async () => {
     const recorded = installFetch();
-    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key' });
+    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key', baseUrl: 'https://configured.example.com/v1' });
     await client.createFile({ name: 'demo.bin' });
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/files`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/files`);
     expect(recorded[0].method).toBe('POST');
   });
 
   test('search posts to /search', async () => {
     const recorded = installFetch();
-    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key' });
+    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key', baseUrl: 'https://configured.example.com/v1' });
     await client.search({ q: 'report' });
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/search`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/search`);
     expect(recorded[0].method).toBe('POST');
   });
 
   test('rawRequest honors custom path and method', async () => {
     const recorded = installFetch();
-    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key' });
+    const client = new WriteBinaryFileClient({ apiKey: 'write-binary-file-key', baseUrl: 'https://configured.example.com/v1' });
     await client.rawRequest({ path: '/events', method: 'GET', query: { limit: 5 } });
-    expect(recorded[0].url).toBe(`${DEFAULT_BASE_URL}/events?limit=5`);
+    expect(recorded[0].url).toBe(`https://configured.example.com/v1/events?limit=5`);
     expect(recorded[0].method).toBe('GET');
   });
 
   test('requires api key', () => {
-    expect(() => new WriteBinaryFileClient({ apiKey: '' })).toThrow('API key is required');
+    expect(() => new WriteBinaryFileClient({ apiKey: '', baseUrl: 'https://configured.example.com/v1' })).toThrow('API key is required');
+  });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new WriteBinaryFileClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
   });
 });

package/connectors/write-binary-file/src/api/client.ts

@@ -6,8 +6,6 @@ import {
   type WriteBinaryFileConfig,
 } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.write-binary-file.com/v1';
-
 export function encodePathSegment(value: string): string {
   return encodeURIComponent(value);
 }
@@ -32,7 +30,10 @@ export class WriteBinaryFileClient {
       throw new Error('API key is required');
     }
     this.apiKey = config.apiKey;
-    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
+    if (!config.baseUrl) {
+      throw new Error('baseUrl is required: no default endpoint is configured; set baseUrl (profile, config, or the connector BASE_URL environment variable)');
+    }
+    this.baseUrl = config.baseUrl.replace(/\/$/, '');
   }
 
   private buildUrl(path: string, query?: Record<string, string | number | boolean | undefined>): string {

package/connectors/write-binary-file/src/api/index.ts

@@ -53,4 +53,4 @@ export class WriteBinaryFile {
   }
 }
 
-export { WriteBinaryFileClient, DEFAULT_BASE_URL, encodePathSegment } from './client';
+export { WriteBinaryFileClient, encodePathSegment } from './client';

package/connectors/write-binary-file/src/index.ts

@@ -2,7 +2,7 @@
 
 export { WriteBinaryFile } from './api';
 export * from './types';
-export { WriteBinaryFileClient, DEFAULT_BASE_URL, encodePathSegment } from './api';
+export { WriteBinaryFileClient, encodePathSegment } from './api';
 
 export {
   getApiKey,

package/connectors/wubookratechecker/src/api/client.test.ts

@@ -0,0 +1,34 @@
+import { afterEach, describe, expect, test } from 'bun:test';
+import { WuBookrateClient } from './client';
+
+const realFetch = globalThis.fetch;
+
+afterEach(() => {
+  globalThis.fetch = realFetch;
+});
+
+describe('WuBookrateClient transport', () => {
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new WuBookrateClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
+
+  test('sends the API key only to the configured base URL', async () => {
+    const recorded: string[] = [];
+    globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
+      recorded.push(typeof input === 'string' ? input : input.toString());
+      return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        headers: new Headers({ 'content-type': 'application/json' }),
+        async text() { return JSON.stringify({ ok: true }); },
+        async json() { return { ok: true }; },
+      } as Response;
+    }) as typeof fetch;
+    const client = new WuBookrateClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
+    await client.request('/ping');
+    expect(recorded).toHaveLength(1);
+    expect(recorded[0].startsWith('https://configured.example.com/v1/')).toBe(true);
+    expect(recorded[0]).not.toContain('api.wubookratechecker.com');
+  });
+});

package/connectors/wubookratechecker/src/api/client.ts

@@ -3,11 +3,13 @@ import { WuBookrateApiError } from '../types';
 
 export class WuBookrateClient {
   private readonly apiKey: string;
-  private readonly baseUrl = 'https://api.wubookratechecker.com/v1';
+  private readonly baseUrl: string;
 
   constructor(config: WuBookrateConfig) {
     if (!config.apiKey) throw new Error('Wu Bookrate Checker apiKey is required');
+    if (!config.baseUrl) throw new Error('baseUrl is required: no default endpoint is configured; set baseUrl (profile, config, or the connector BASE_URL environment variable)');
     this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl;
   }
 
   async request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T> {

package/connectors/wubookratechecker/src/api/index.ts

@@ -9,7 +9,7 @@ export class WuBookrateChecker {
   static fromEnv(): WuBookrateChecker {
     const apiKey = process.env.WUBOOKRATE_API_KEY;
     if (!apiKey) throw new Error('WUBOOKRATE_API_KEY is required');
-    return new WuBookrateChecker({ apiKey });
+    return new WuBookrateChecker({ apiKey, baseUrl: process.env.WUBOOKRATE_BASE_URL });
   }
 
   async lookupByISBN(isbn: string): Promise<WBBook> { return this.client.request<WBBook>(`/books/${isbn}`); }