@hasna/connectors 1.4.2 → 1.4.4

package/connectors/travo-real-estate/src/api/client.test.ts

@@ -15,11 +15,11 @@ describe('ConnectorClient', () => {
   });
 
   test('requires apiKey', () => {
-    expect(() => new ConnectorClient({ apiKey: '' })).toThrow('API key is required');
+    expect(() => new ConnectorClient({ apiKey: '', baseUrl: 'https://configured.example.com/v1' })).toThrow('API key is required');
   });
 
   test('creates client with valid config', () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     expect(client.getApiKeyPreview()).toBe('travo-...-key');
   });
 
@@ -33,12 +33,12 @@ describe('ConnectorClient', () => {
   });
 
   test('builds default listings URL', () => {
-    const client = new ConnectorClient({ apiKey: 'key' });
-    expect(client.buildRequestUrl('/listings')).toBe('https://api.travo-real-estate.com/v1/listings');
+    const client = new ConnectorClient({ apiKey: 'key', baseUrl: 'https://configured.example.com/v1' });
+    expect(client.buildRequestUrl('/listings')).toBe('https://configured.example.com/v1/listings');
   });
 
   test('sends Bearer authorization header', async () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     const captured: Array<{ url: string; init?: RequestInit }> = [];
 
     globalThis.fetch = mock(async (input: string | URL | Request, init?: RequestInit) => {
@@ -50,12 +50,12 @@ describe('ConnectorClient', () => {
     }) as any;
 
     await client.get('/listings');
-    expect(captured[0]?.url).toBe('https://api.travo-real-estate.com/v1/listings');
+    expect(captured[0]?.url).toBe('https://configured.example.com/v1/listings');
     expect(new Headers(captured[0]?.init?.headers).get('Authorization')).toBe('Bearer travo-real-estate-key');
   });
 
   test('GET listing by ID uses encoded path', async () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     const captured: string[] = [];
 
     globalThis.fetch = mock(async (input: string | URL | Request) => {
@@ -64,11 +64,11 @@ describe('ConnectorClient', () => {
     }) as any;
 
     await client.get('/listings/item-1');
-    expect(captured[0]).toBe('https://api.travo-real-estate.com/v1/listings/item-1');
+    expect(captured[0]).toBe('https://configured.example.com/v1/listings/item-1');
   });
 
   test('GET events endpoint', async () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     const captured: string[] = [];
 
     globalThis.fetch = mock(async (input: string | URL | Request) => {
@@ -77,11 +77,11 @@ describe('ConnectorClient', () => {
     }) as any;
 
     await client.get('/events', { limit: 10 });
-    expect(captured[0]).toBe('https://api.travo-real-estate.com/v1/events?limit=10');
+    expect(captured[0]).toBe('https://configured.example.com/v1/events?limit=10');
   });
 
   test('POST search endpoint', async () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     const captured: Array<{ url: string; init?: RequestInit }> = [];
 
     globalThis.fetch = mock(async (input: string | URL | Request, init?: RequestInit) => {
@@ -93,13 +93,13 @@ describe('ConnectorClient', () => {
     }) as any;
 
     await client.post('/search', { query: 'apartment' });
-    expect(captured[0]?.url).toBe('https://api.travo-real-estate.com/v1/search');
+    expect(captured[0]?.url).toBe('https://configured.example.com/v1/search');
     expect(captured[0]?.init?.method).toBe('POST');
     expect(captured[0]?.init?.body).toBe(JSON.stringify({ query: 'apartment' }));
   });
 
   test('throws ConnectorApiError on HTTP error', async () => {
-    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key' });
+    const client = new ConnectorClient({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
 
     globalThis.fetch = mock(async () =>
       new Response('Unauthorized', { status: 401, statusText: 'Unauthorized' })
@@ -128,7 +128,7 @@ describe('TravoRealEstate', () => {
   });
 
   test('listListings and getListing hit expected paths', async () => {
-    const connector = new TravoRealEstate({ apiKey: 'travo-real-estate-key' });
+    const connector = new TravoRealEstate({ apiKey: 'travo-real-estate-key', baseUrl: 'https://configured.example.com/v1' });
     const captured: string[] = [];
 
     globalThis.fetch = mock(async (input: string | URL | Request) => {
@@ -139,8 +139,8 @@ describe('TravoRealEstate', () => {
     await connector.listListings();
     await connector.getListing('item-1');
 
-    expect(captured[0]).toBe('https://api.travo-real-estate.com/v1/listings');
-    expect(captured[1]).toBe('https://api.travo-real-estate.com/v1/listings/item-1');
+    expect(captured[0]).toBe('https://configured.example.com/v1/listings');
+    expect(captured[1]).toBe('https://configured.example.com/v1/listings/item-1');
   });
 });
 
@@ -151,4 +151,8 @@ describe('ConnectorApiError', () => {
     expect(err.responseBody).toBe('{"error":"invalid_key"}');
     expect(err.name).toBe('ConnectorApiError');
   });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new ConnectorClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
 });

package/connectors/travo-real-estate/src/api/client.ts

@@ -1,8 +1,6 @@
 import type { ConnectorConfig, QueryParams, RawRequestOptions } from '../types';
 import { ConnectorApiError, parseApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.travo-real-estate.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: QueryParams;
@@ -21,7 +19,10 @@ export class ConnectorClient {
       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, params?: QueryParams): string {

package/connectors/travo-real-estate/src/utils/config.ts

@@ -4,7 +4,6 @@ import { join } from 'path';
 
 const CONNECTOR_NAME = 'connect-travo-real-estate';
 const DEFAULT_PROFILE = 'default';
-const DEFAULT_BASE_URL = 'https://api.travo-real-estate.com/v1';
 
 export interface ProfileConfig {
   apiKey?: string;
@@ -146,8 +145,8 @@ export function setApiKey(apiKey: string): void {
   saveProfile(config);
 }
 
-export function getBaseUrl(): string {
-  return process.env.TRAVO_REAL_ESTATE_BASE_URL || loadProfile().baseUrl || DEFAULT_BASE_URL;
+export function getBaseUrl(): string | undefined {
+  return process.env.TRAVO_REAL_ESTATE_BASE_URL || loadProfile().baseUrl;
 }
 
 export function setBaseUrl(baseUrl: string): void {
@@ -168,4 +167,3 @@ export function getActiveProfileName(): string {
   return getCurrentProfile();
 }
 
-export { DEFAULT_BASE_URL };

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

@@ -4,7 +4,7 @@ Tray API Platform connector — customer runtime REST API for items, events, and
 
 ## API Details
 
-- **Base URL**: `https://api.trayapiplatform.com/v1` (tenant-specific override supported)
+- **Base URL**: no default (must be configured) (tenant-specific override supported)
 - **Auth**: API key via Bearer token (`Authorization: Bearer <api_key>`)
 - **Not** the tray.io iPaaS or Tray Platform workspace management API
 

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

@@ -1,6 +1,6 @@
 import { afterEach, describe, expect, test } from 'bun:test';
+import { ConnectorClient } from './client';
 import { Connector } from './index';
-import { DEFAULT_BASE_URL } from './client';
 
 const realFetch = globalThis.fetch;
 
@@ -62,12 +62,12 @@ describe('Tray API Platform client', () => {
   test('listItems sends Bearer auth and GET /items', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('GET');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/items`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/items`);
       expect(entry.headers.authorization).toBe('Bearer test-api-key');
       return { items: [] };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await connector.items.list();
     expect(result).toEqual({ items: [] });
     expect(recorded).toHaveLength(1);
@@ -76,12 +76,12 @@ describe('Tray API Platform client', () => {
   test('getItem encodes item ID and calls GET /items/:id', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('GET');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/items/item%2F123`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/items/item%2F123`);
       expect(entry.headers.authorization).toBe('Bearer test-api-key');
       return { id: 'item/123' };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await connector.items.get('item/123');
     expect(result).toEqual({ id: 'item/123' });
     expect(recorded).toHaveLength(1);
@@ -90,12 +90,12 @@ describe('Tray API Platform client', () => {
   test('createItem POSTs JSON body to /items', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('POST');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/items`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/items`);
       expect(entry.body).toBe(JSON.stringify({ name: 'widget' }));
       return { id: 'new-item' };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     await connector.items.create({ name: 'widget' });
     expect(recorded).toHaveLength(1);
   });
@@ -117,12 +117,12 @@ describe('Tray API Platform client', () => {
   test('listEvents sends GET /events', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('GET');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/events`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/events`);
       expect(entry.headers.authorization).toBe('Bearer test-api-key');
       return { events: [] };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await connector.events.list();
     expect(result).toEqual({ events: [] });
     expect(recorded).toHaveLength(1);
@@ -131,12 +131,12 @@ describe('Tray API Platform client', () => {
   test('search POSTs JSON body to /search', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('POST');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/search`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/search`);
       expect(entry.body).toBe(JSON.stringify({ query: 'widget' }));
       return { results: [] };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await connector.search.search({ query: 'widget' });
     expect(result).toEqual({ results: [] });
     expect(recorded).toHaveLength(1);
@@ -145,12 +145,12 @@ describe('Tray API Platform client', () => {
   test('rawRequest supports custom path and method', async () => {
     const recorded = installFetch((entry) => {
       expect(entry.method).toBe('POST');
-      expect(entry.url).toBe(`${DEFAULT_BASE_URL}/custom/path`);
+      expect(entry.url).toBe(`https://configured.example.com/v1/custom/path`);
       expect(entry.body).toBe(JSON.stringify({ action: 'ping' }));
       return { ok: true };
     });
 
-    const connector = new Connector({ apiKey: 'test-api-key' });
+    const connector = new Connector({ apiKey: 'test-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await connector.rawRequest({
       method: 'POST',
       path: '/custom/path',
@@ -163,4 +163,8 @@ describe('Tray API Platform client', () => {
   test('requires API key', () => {
     expect(() => new Connector({})).toThrow('API key or token is required');
   });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new ConnectorClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
 });

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

@@ -1,8 +1,6 @@
 import type { ConnectorConfig, ListQueryParams } from '../types';
 import { ConnectorApiError, parseApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.trayapiplatform.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: ListQueryParams;
@@ -22,7 +20,10 @@ export class ConnectorClient {
       throw new Error('API key or token 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/tray-api-platform/src/api/index.ts

@@ -43,7 +43,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/tray-api-platform/src/cli/index.ts

@@ -219,7 +219,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('https://api.trayapiplatform.com/v1 (default)')}`);
+    info(`Base URL: ${baseUrl || chalk.gray('none configured')}`);
   });
 
 configCmd

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

@@ -2,7 +2,6 @@ export { Connector } from './api';
 export * from './types';
 export {
   ConnectorClient,
-  DEFAULT_BASE_URL,
   ItemsApi,
   EventsApi,
   SearchApi,

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

@@ -20,7 +20,7 @@ bun test
 
 Bearer token via `Authorization: Bearer <api_key>` header.
 
-Default base URL: `https://api.tursoapiplatform.com/v1`
+Default base URL: none (must be configured)
 
 Credentials stored in `~/.hasna/connectors/connect-turso-api-platform/profiles/`.
 

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

@@ -1,6 +1,6 @@
 # Turso Api Platform Connector
 
-TypeScript connector and CLI for the [Turso Api Platform](https://api.tursoapiplatform.com) REST API.
+TypeScript connector and CLI for the [Turso Api Platform](configured.example.com/v1) REST API.
 
 ## Features
 
@@ -19,7 +19,7 @@ bun install
 
 ```bash
 connect-turso-api-platform auth set-key <api-key>
-connect-turso-api-platform auth set-base-url https://api.tursoapiplatform.com/v1
+connect-turso-api-platform auth set-base-url configured.example.com/v1
 connect-turso-api-platform auth status
 ```
 

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

@@ -1,21 +1,21 @@
 import { describe, test, expect, mock, beforeEach, afterEach } from 'bun:test';
-import { TursoApiPlatformClient, DEFAULT_BASE_URL } from './client';
+import { TursoApiPlatformClient } from './client';
 import { TursoApiPlatform } from './index';
 import { TursoApiPlatformApiError } from '../types';
 
 describe('TursoApiPlatformClient', () => {
   test('requires apiKey', () => {
-    expect(() => new TursoApiPlatformClient({ apiKey: '' })).toThrow('API key is required');
+    expect(() => new TursoApiPlatformClient({ apiKey: '', baseUrl: 'https://configured.example.com/v1' })).toThrow('API key is required');
   });
 
   test('builds canonical items URL', () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'test-key' });
-    expect(client.buildUrl('/items')).toBe(`${DEFAULT_BASE_URL}/items`);
+    const client = new TursoApiPlatformClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
+    expect(client.buildUrl('/items')).toBe(`https://configured.example.com/v1/items`);
   });
 
   test('builds canonical item-by-id URL', () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'test-key' });
-    expect(client.buildUrl('/items/item-123')).toBe(`${DEFAULT_BASE_URL}/items/item-123`);
+    const client = new TursoApiPlatformClient({ apiKey: 'test-key', baseUrl: 'https://configured.example.com/v1' });
+    expect(client.buildUrl('/items/item-123')).toBe(`https://configured.example.com/v1/items/item-123`);
   });
 
   test('respects custom base URL', () => {
@@ -27,7 +27,7 @@ describe('TursoApiPlatformClient', () => {
   });
 
   test('getApiKeyPreview masks key', () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'abcdef1234567890' });
+    const client = new TursoApiPlatformClient({ apiKey: 'abcdef1234567890', baseUrl: 'https://configured.example.com/v1' });
     expect(client.getApiKeyPreview()).toBe('abcdef...7890');
   });
 });
@@ -44,7 +44,7 @@ describe('TursoApiPlatformClient request', () => {
   });
 
   test('sends Bearer authorization header on list items', async () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key' });
+    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key', baseUrl: 'https://configured.example.com/v1' });
     let capturedUrl = '';
     let capturedHeaders: Headers | undefined;
 
@@ -60,13 +60,13 @@ describe('TursoApiPlatformClient request', () => {
     }) as unknown as typeof fetch;
 
     const result = await client.get('/items');
-    expect(capturedUrl).toBe(`${DEFAULT_BASE_URL}/items`);
+    expect(capturedUrl).toBe(`https://configured.example.com/v1/items`);
     expect(capturedHeaders?.get('Authorization')).toBe('Bearer secret-api-key');
     expect(result).toEqual([{ id: '1', name: 'alpha' }]);
   });
 
   test('sends Bearer authorization header on get item', async () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key' });
+    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key', baseUrl: 'https://configured.example.com/v1' });
     let capturedUrl = '';
     let capturedHeaders: Headers | undefined;
 
@@ -81,16 +81,16 @@ describe('TursoApiPlatformClient request', () => {
       );
     }) as unknown as typeof fetch;
 
-    const api = new TursoApiPlatform({ apiKey: 'secret-api-key' });
+    const api = new TursoApiPlatform({ apiKey: 'secret-api-key', baseUrl: 'https://configured.example.com/v1' });
     const result = await api.getItem('item-42');
 
-    expect(capturedUrl).toBe(`${DEFAULT_BASE_URL}/items/item-42`);
+    expect(capturedUrl).toBe(`https://configured.example.com/v1/items/item-42`);
     expect(capturedHeaders?.get('Authorization')).toBe('Bearer secret-api-key');
     expect(result).toEqual({ id: 'item-42', name: 'beta' });
   });
 
   test('throws TursoApiPlatformApiError on HTTP error', async () => {
-    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key' });
+    const client = new TursoApiPlatformClient({ apiKey: 'secret-api-key', baseUrl: 'https://configured.example.com/v1' });
 
     globalThis.fetch = mock(() =>
       Promise.resolve(
@@ -103,4 +103,8 @@ describe('TursoApiPlatformClient request', () => {
 
     await expect(client.get('/items')).rejects.toThrow(TursoApiPlatformApiError);
   });
+
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new TursoApiPlatformClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
+  });
 });

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

@@ -1,8 +1,6 @@
 import type { TursoApiPlatformConfig, TursoApiPlatformErrorResponse } from '../types';
 import { TursoApiPlatformApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.tursoapiplatform.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: Record<string, string | number | boolean | undefined>;
@@ -19,7 +17,10 @@ export class TursoApiPlatformClient {
       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(/\/$/, '');
   }
 
   buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string {

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

@@ -55,7 +55,7 @@ authCmd
 authCmd
   .command('set-base-url')
   .description('Set custom API base URL')
-  .argument('<url>', 'Base URL (e.g. https://api.tursoapiplatform.com/v1)')
+  .argument('<url>', 'Base URL (e.g. https://configured.example.com/v1)')
   .action((url: string) => {
     setBaseUrl(url);
     console.log(chalk.green(`Base URL saved to profile "${getCurrentProfile()}"`));
@@ -76,7 +76,7 @@ authCmd
 
     console.log(chalk.bold('Configuration:'));
     console.log(`  Profile: ${chalk.cyan(getCurrentProfile())}`);
-    console.log(`  Base URL: ${chalk.white(baseUrl || 'https://api.tursoapiplatform.com/v1 (default)')}`);
+    console.log(`  Base URL: ${chalk.white(baseUrl || 'none configured')}`);
     console.log(`  API Key: ${chalk.green('Set')}`);
 
     try {

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

@@ -4,7 +4,7 @@ Guidance for working with the Twilio Api Platform connector.
 
 ## Overview
 
-`connect-twilio-api-platform` is a TypeScript CLI and library for the Twilio Api Platform REST API (`https://api.twilioapiplatform.com/v1`). This is distinct from `connect-twilio` (classic Twilio SMS/voice at `api.twilio.com`).
+`connect-twilio-api-platform` is a TypeScript CLI and library for the Twilio Api Platform REST API (`configured.example.com/v1`). This is distinct from `connect-twilio` (classic Twilio SMS/voice at `api.twilio.com`).
 
 ## Commands
 

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

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, mock, test } from 'bun:test';
-import { TwilioApiPlatform, TwilioApiPlatformClient, DEFAULT_BASE_URL } from './index';
+import { TwilioApiPlatform, TwilioApiPlatformClient } from './index';
 import { TwilioApiPlatformApiError } from '../types';
 
 const realFetch = globalThis.fetch;
@@ -26,29 +26,29 @@ afterEach(() => {
 
 describe('TwilioApiPlatformClient', () => {
   test('requires api key', () => {
-    expect(() => new TwilioApiPlatformClient({ apiKey: '' })).toThrow('API key is required');
+    expect(() => new TwilioApiPlatformClient({ apiKey: '', baseUrl: 'https://configured.example.com/v1' })).toThrow('API key is required');
   });
 
-  test('uses default base URL', () => {
-    expect(DEFAULT_BASE_URL).toBe('https://api.twilioapiplatform.com/v1');
+  test('refuses to send without a configured base URL (no default endpoint)', () => {
+    expect(() => new TwilioApiPlatformClient({ apiKey: 'test-key' })).toThrow(/baseUrl/);
   });
 
   test('listItems sends Bearer auth to /items', async () => {
     const captured = installFetch();
-    const client = new TwilioApiPlatformClient({ apiKey: 'twilio-api-platform-key' });
+    const client = new TwilioApiPlatformClient({ apiKey: 'twilio-api-platform-key', baseUrl: 'https://configured.example.com/v1' });
     await client.get('/items');
 
     expect(captured).toHaveLength(1);
-    expect(captured[0].url).toBe('https://api.twilioapiplatform.com/v1/items');
+    expect(captured[0].url).toBe('https://configured.example.com/v1/items');
     expect(new Headers(captured[0].init?.headers).get('Authorization')).toBe('Bearer twilio-api-platform-key');
   });
 
   test('getItem encodes item id in path', async () => {
     const captured = installFetch();
-    const api = new TwilioApiPlatform({ apiKey: 'twilio-api-platform-key' });
+    const api = new TwilioApiPlatform({ apiKey: 'twilio-api-platform-key', baseUrl: 'https://configured.example.com/v1' });
     await api.getItem('item-1');
 
-    expect(captured[0].url).toBe('https://api.twilioapiplatform.com/v1/items/item-1');
+    expect(captured[0].url).toBe('https://configured.example.com/v1/items/item-1');
     expect(new Headers(captured[0].init?.headers).get('Authorization')).toBe('Bearer twilio-api-platform-key');
   });
 
@@ -65,11 +65,11 @@ describe('TwilioApiPlatformClient', () => {
 
   test('search posts JSON body to /search', async () => {
     const captured = installFetch();
-    const api = new TwilioApiPlatform({ apiKey: 'key' });
+    const api = new TwilioApiPlatform({ apiKey: 'key', baseUrl: 'https://configured.example.com/v1' });
     await api.search({ q: 'hello' });
 
     const request = captured[0];
-    expect(request.url).toBe('https://api.twilioapiplatform.com/v1/search');
+    expect(request.url).toBe('https://configured.example.com/v1/search');
     expect(request.init?.method).toBe('POST');
     expect(request.init?.body).toBe(JSON.stringify({ q: 'hello' }));
   });
@@ -79,7 +79,7 @@ describe('TwilioApiPlatformClient', () => {
       Response.json({ message: 'Unauthorized' }, { status: 401 }),
     ) as unknown as typeof fetch;
 
-    const client = new TwilioApiPlatformClient({ apiKey: 'bad-key' });
+    const client = new TwilioApiPlatformClient({ apiKey: 'bad-key', baseUrl: 'https://configured.example.com/v1' });
     await expect(client.get('/items')).rejects.toThrow(TwilioApiPlatformApiError);
   });
 });

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

@@ -1,8 +1,6 @@
 import type { TwilioApiPlatformConfig } from '../types';
 import { parseApiError } from '../types';
 
-export const DEFAULT_BASE_URL = 'https://api.twilioapiplatform.com/v1';
-
 export interface RequestOptions {
   method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
   params?: Record<string, string | number | boolean | undefined>;
@@ -19,7 +17,10 @@ export class TwilioApiPlatformClient {
       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, params?: Record<string, string | number | boolean | undefined>): string {

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

@@ -1,7 +1,7 @@
 import type { TwilioApiPlatformConfig, TwilioApiPlatformResponse } from '../types';
 import { TwilioApiPlatformClient, type RequestOptions } from './client';
 
-export { TwilioApiPlatformClient, DEFAULT_BASE_URL } from './client';
+export { TwilioApiPlatformClient } from './client';
 
 export class TwilioApiPlatform {
   private readonly client: TwilioApiPlatformClient;

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

@@ -202,7 +202,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 || 'https://api.twilioapiplatform.com/v1 (default)'}`);
+    info(`Base URL: ${baseUrl || 'none configured'}`);
   });
 
 configCmd

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

@@ -1,4 +1,4 @@
-export { TwilioApiPlatform, TwilioApiPlatformClient, DEFAULT_BASE_URL } from './api';
+export { TwilioApiPlatform, TwilioApiPlatformClient } from './api';
 export * from './types';
 
 export {

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

@@ -1,5 +1,5 @@
 # Tyk API Platform credentials
 TYK_API_PLATFORM_API_KEY=your-api-key-here
 
-# Optional: override the API base URL (default: https://api.tykapiplatform.com/v1)
+# Optional: override the API base URL (no default - must be configured)
 # TYK_API_PLATFORM_BASE_URL=https://api.tykapiplatform.com/v1

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

@@ -53,7 +53,7 @@ connect-tyk-api-platform raw --path /search --method POST --data '{"query":"test
 | Variable | Description |
 |----------|-------------|
 | `TYK_API_PLATFORM_API_KEY` | API key (overrides profile config) |
-| `TYK_API_PLATFORM_BASE_URL` | API base URL (default: `https://api.tykapiplatform.com/v1`) |
+| `TYK_API_PLATFORM_BASE_URL` | API base URL (default: `configured.example.com/v1`) |
 
 ## Authentication
 
@@ -73,7 +73,7 @@ Profile JSON structure:
 ```json
 {
   "apiKey": "your-api-key",
-  "baseUrl": "https://api.tykapiplatform.com/v1"
+  "baseUrl": "configured.example.com/v1"
 }
 ```