@ewyn/client 0.2.0 → 0.3.0

package/README.md

@@ -27,7 +27,6 @@ import { Ewyn } from '@ewyn/client';
 const client = new Ewyn({
   workspaceId: 'your-workspace-id',
   apiKey: 'your-api-key',
-  baseUrl: 'https://www.ewyn.ai/api/v1', // optional; omit to use production default
 });
 
 // Send an email using template version ID
@@ -91,7 +90,58 @@ await client.send({
 
 ## Getting Your Template Configuration
 
-### From Dashboard (Recommended)
+You can get your template config in three ways:
+
+1. **CLI (recommended)** – Run `npx @ewyn/client fetch-config` to download config and generate `ewynTemplates.ts` (see [Fetching template config (CLI)](#fetching-template-config-cli)).
+2. **Dashboard** – Copy JSON from the API Keys page.
+3. **API** – Call the templates config endpoint with curl or your own code.
+
+### Fetching template config (CLI)
+
+The easiest way to keep your template config in sync is to use the built-in CLI. From your project root (where you have an `ewyn.config.ts` or `ewyn.config.js`), run:
+
+```bash
+npx @ewyn/client fetch-config
+```
+
+This fetches your workspace’s template config from the API and writes a TypeScript file (e.g. `ewynTemplates.ts`) that you can import for type-safe sending.
+
+**Config file** (`ewyn.config.ts` in project root):
+
+- `workspaceId` (required): Your workspace UUID (e.g. `process.env.EWYN_WORKSPACE_ID`)
+- `apiKey` (required): Your API key (e.g. `process.env.EWYN_API_KEY`)
+- `configurationPath` (optional): Where to write the generated file (e.g. `./src/ewynTemplates.ts`). If omitted, the file is written as `./ewynTemplates.ts` in the current directory.
+
+Example `ewyn.config.ts`:
+
+```typescript
+import type { EwynFetchConfig } from '@ewyn/client';
+
+const config: EwynFetchConfig = {
+  workspaceId: process.env.EWYN_WORKSPACE_ID!,
+  apiKey: process.env.EWYN_API_KEY!,
+  configurationPath: './src/ewynTemplates.ts',  // optional
+};
+
+export default config;
+```
+
+After running `fetch-config`, import the generated config and pass it to the client:
+
+```typescript
+import { Ewyn } from '@ewyn/client';
+import { ewynTemplates } from './ewynTemplates';  // or from your configurationPath
+
+const client = new Ewyn({
+  workspaceId: process.env.EWYN_WORKSPACE_ID!,
+  apiKey: process.env.EWYN_API_KEY!,
+  templates: ewynTemplates,
+});
+```
+
+**Note:** Regenerate the config after creating or updating templates (re-run `npx @ewyn/client fetch-config`).
+
+### From Dashboard
 
 1. Go to your dashboard → **API Keys** page
 2. Scroll to **Template Configuration** section
@@ -119,8 +169,6 @@ curl -X GET https://www.ewyn.ai/api/v1/workspaces/YOUR_WORKSPACE_ID/templates/co
   -H "Authorization: Bearer YOUR_API_KEY"
 ```
 
-**Note:** Regenerate the config after creating or updating templates to keep it in sync.
-
 ## API Reference
 
 ### `Ewyn` Class
@@ -135,7 +183,6 @@ new Ewyn(options: EwynOptions)
 
 - `workspaceId` (string, required): Your workspace UUID
 - `apiKey` (string, required): Your API key secret
-- `baseUrl` (string, optional): Base URL for the API (defaults to `https://www.ewyn.ai/api/v1`)
 - `templates` (TemplateConfig, optional): Template configuration for name-based sending
 - `maxRetries` (number, optional): Maximum retries for retryable errors (default: 3)
 - `timeout` (number, optional): Request timeout in milliseconds (default: 30000)
@@ -235,6 +282,7 @@ Check out the [examples directory](./examples/) for comprehensive examples:
 
 - [Basic send](./examples/basic-send.ts) - Simple sending with template ID
 - [Type-safe usage](./examples/with-template-config.ts) - Full type safety with template config
+- [ewyn.config example](./examples/ewyn.config.example.ts) - Example config for `fetch-config` CLI
 - [Error handling](./examples/error-handling.ts) - Comprehensive error handling patterns
 - [Idempotency](./examples/idempotency.ts) - Preventing duplicate sends
 - [Advanced patterns](./examples/advanced-usage.ts) - Batch sending, retries, and more

package/dist/__tests__/cli-fetch-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-fetch-config.test.d.ts.map

package/dist/__tests__/cli-fetch-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-fetch-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-fetch-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cli-fetch-config.test.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runFetchConfig } from '../cli.js';
+const MOCK_TEMPLATES = {
+    welcome: {
+        id: 'version-uuid-1',
+        name: 'Welcome Email',
+        version: 1,
+        vars: {
+            firstName: { required: true },
+            lastName: { required: false },
+        },
+    },
+};
+describe('fetch-config CLI', () => {
+    let tempDir;
+    let originalFetch;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ewyn-cli-test-'));
+        originalFetch = globalThis.fetch;
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: async () => ({ templates: MOCK_TEMPLATES }),
+            text: async () => '',
+        });
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+        try {
+            fs.rmSync(tempDir, { recursive: true });
+        }
+        catch {
+            // ignore
+        }
+    });
+    it('writes ewynTemplates.ts with fetched config when using default path', async () => {
+        const configPath = path.join(tempDir, 'ewyn.config.js');
+        fs.writeFileSync(configPath, `export default {
+  workspaceId: 'test-workspace-id',
+  apiKey: 'test-api-key',
+};
+`, 'utf-8');
+        await runFetchConfig(tempDir);
+        const outputPath = path.join(tempDir, 'ewynTemplates.ts');
+        expect(fs.existsSync(outputPath)).toBe(true);
+        const content = fs.readFileSync(outputPath, 'utf-8');
+        expect(content).toContain('// Generated by @ewyn/client fetch-config');
+        expect(content).toContain('export const ewynTemplates = ');
+        expect(content).toContain('"welcome"');
+        expect(content).toContain('"version-uuid-1"');
+        expect(content).toContain(' as const;');
+    });
+    it('writes to configurationPath when set in config', async () => {
+        const configPath = path.join(tempDir, 'ewyn.config.js');
+        fs.writeFileSync(configPath, `export default {
+  workspaceId: 'ws-1',
+  apiKey: 'key-1',
+  configurationPath: './src/ewynTemplates.ts',
+};
+`, 'utf-8');
+        await runFetchConfig(tempDir);
+        const outputPath = path.join(tempDir, 'src', 'ewynTemplates.ts');
+        expect(fs.existsSync(outputPath)).toBe(true);
+        const content = fs.readFileSync(outputPath, 'utf-8');
+        expect(content).toContain('"welcome"');
+    });
+});

package/dist/__tests__/dashboard-config.test.js

@@ -48,7 +48,6 @@ describe('Dashboard config (runtime)', () => {
         const client = new Ewyn({
             workspaceId: 'ws-1',
             apiKey: 'key-1',
-            baseUrl: 'https://api.test.com/api/v1',
             templates: configOnlyRequired,
             maxRetries: 1,
             timeout: 5000,
@@ -72,7 +71,7 @@ describe('Dashboard config (runtime)', () => {
             },
         });
         expect(result).toEqual(mockResponse);
-        expect(global.fetch).toHaveBeenCalledWith('https://api.test.com/api/v1/workspaces/ws-1/send', expect.objectContaining({
+        expect(global.fetch).toHaveBeenCalledWith('https://www.ewyn.ai/api/v1/workspaces/ws-1/send', expect.objectContaining({
             method: 'POST',
             body: expect.stringContaining('"templateId":"version-uuid-1"'),
         }));
@@ -84,7 +83,6 @@ describe('Dashboard config (runtime)', () => {
         const client = new Ewyn({
             workspaceId: 'ws-2',
             apiKey: 'key-2',
-            baseUrl: 'https://api.test.com/api/v1',
             templates: configMixedVars,
             maxRetries: 1,
             timeout: 5000,
@@ -120,7 +118,6 @@ describe('Dashboard config (runtime)', () => {
         const client = new Ewyn({
             workspaceId: 'ws-3',
             apiKey: 'key-3',
-            baseUrl: 'https://api.test.com/api/v1',
             templates: configEmptyVars,
             maxRetries: 1,
             timeout: 5000,
@@ -150,7 +147,6 @@ describe('Dashboard config (runtime)', () => {
         const client = new Ewyn({
             workspaceId: 'ws-1',
             apiKey: 'key-1',
-            baseUrl: 'https://api.test.com/api/v1',
             templates: configOnlyRequired,
             maxRetries: 1,
             timeout: 5000,
@@ -168,7 +164,6 @@ describe('Dashboard config (runtime)', () => {
         const client = new Ewyn({
             workspaceId: 'ws-1',
             apiKey: 'key-1',
-            baseUrl: 'https://api.test.com/api/v1',
             templates: configOnlyRequired,
             maxRetries: 1,
             timeout: 5000,

package/dist/__tests__/errors.test.js

@@ -1,4 +1,4 @@
-import { describe, it, expect } from 'vitest';
+import { describe, expect, it } from 'vitest';
 import { EwynApiError } from '../errors.js';
 describe('EwynApiError', () => {
     describe('constructor', () => {

package/dist/__tests__/ewyn.test.js

@@ -10,7 +10,6 @@ describe('Ewyn SDK', () => {
         client = new Ewyn({
             workspaceId: 'test-workspace-id',
             apiKey: 'test-api-key',
-            baseUrl: 'https://api.test.com/api/v1',
             maxRetries: 2, // Allow 1 retry (attempt < maxRetries)
             timeout: 5000,
         });
@@ -65,7 +64,7 @@ describe('Ewyn SDK', () => {
                 },
             });
             expect(result).toEqual(mockResponse);
-            expect(global.fetch).toHaveBeenCalledWith('https://api.test.com/api/v1/workspaces/test-workspace-id/send', expect.objectContaining({
+            expect(global.fetch).toHaveBeenCalledWith('https://www.ewyn.ai/api/v1/workspaces/test-workspace-id/send', expect.objectContaining({
                 method: 'POST',
                 headers: expect.objectContaining({
                     'Content-Type': 'application/json',

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** Exported for testing. */
+export declare function runFetchConfig(cwd: string): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA+GA,4BAA4B;AAC5B,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D"}

package/dist/cli.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+const EWYN_API_BASE_URL = 'https://www.ewyn.ai/api/v1';
+const CONFIG_NAMES = ['ewyn.config.ts', 'ewyn.config.mjs', 'ewyn.config.js'];
+const DEFAULT_OUTPUT_FILE = 'ewynTemplates.ts';
+function printUsage() {
+    console.error(`
+Usage: ewyn <command>
+
+Commands:
+  fetch-config   Fetch template config from the API and write ewynTemplates.ts (or configurationPath from ewyn.config)
+
+Config file (in current working directory):
+  Look for ewyn.config.ts, ewyn.config.mjs, or ewyn.config.js with default export:
+  { workspaceId: string, apiKey: string, configurationPath?: string }
+
+Example ewyn.config.ts:
+  export default {
+    workspaceId: process.env.EWYN_WORKSPACE_ID!,
+    apiKey: process.env.EWYN_API_KEY!,
+    configurationPath: './src/ewynTemplates.ts',  // optional
+  };
+`);
+}
+function findConfigPath(cwd) {
+    for (const name of CONFIG_NAMES) {
+        const p = path.join(cwd, name);
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+async function loadConfig(configPath) {
+    const ext = path.extname(configPath);
+    if (ext === '.ts') {
+        const require = createRequire(import.meta.url);
+        const { register } = require('tsx/cjs');
+        register();
+        const mod = require(configPath);
+        const config = mod?.default;
+        if (!config || typeof config !== 'object') {
+            throw new Error(`${configPath}: expected default export to be a config object`);
+        }
+        return config;
+    }
+    const mod = await import(pathToFileURL(configPath).href);
+    const config = mod?.default;
+    if (!config || typeof config !== 'object') {
+        throw new Error(`${configPath}: expected default export to be a config object`);
+    }
+    return config;
+}
+function validateConfig(config, configPath) {
+    if (!config.workspaceId || typeof config.workspaceId !== 'string') {
+        console.error(`Error: workspaceId is missing or invalid in ${configPath}. You can use process.env.EWYN_WORKSPACE_ID.`);
+        process.exit(1);
+    }
+    if (!config.apiKey || typeof config.apiKey !== 'string') {
+        console.error(`Error: apiKey is missing or invalid in ${configPath}. You can use process.env.EWYN_API_KEY.`);
+        process.exit(1);
+    }
+}
+async function fetchTemplates(workspaceId, apiKey) {
+    const url = `${EWYN_API_BASE_URL}/workspaces/${workspaceId}/templates/config`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        let details = body;
+        try {
+            const json = JSON.parse(body);
+            details = json.error ?? json.message ?? body;
+        }
+        catch {
+            // use raw body
+        }
+        console.error(`Error: API request failed (${response.status}): ${details}`);
+        process.exit(1);
+    }
+    const data = (await response.json());
+    const templates = data.templates ?? {};
+    return templates;
+}
+function serializeTemplates(templates) {
+    const lines = ['// Generated by @ewyn/client fetch-config. Do not edit by hand.', '', 'export const ewynTemplates = '];
+    const json = JSON.stringify(templates, null, 2);
+    // Ensure valid TS: escape any stray characters and add "as const"
+    lines.push(json + ' as const;');
+    return lines.join('\n');
+}
+/** Exported for testing. */
+export async function runFetchConfig(cwd) {
+    const configPath = findConfigPath(cwd);
+    if (!configPath) {
+        console.error('Error: ewyn.config.ts (or ewyn.config.mjs / ewyn.config.js) not found in current directory.');
+        process.exit(1);
+    }
+    const config = await loadConfig(configPath);
+    validateConfig(config, configPath);
+    const outputPath = config.configurationPath
+        ? path.resolve(cwd, config.configurationPath)
+        : path.join(cwd, DEFAULT_OUTPUT_FILE);
+    const templates = await fetchTemplates(config.workspaceId, config.apiKey);
+    const dir = path.dirname(outputPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(outputPath, serializeTemplates(templates), 'utf-8');
+    console.log(`Wrote ${outputPath}`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command || command === '--help' || command === '-h') {
+        printUsage();
+        process.exit(0);
+    }
+    if (command === 'fetch-config') {
+        const cwd = process.cwd();
+        await runFetchConfig(cwd);
+        return;
+    }
+    console.error(`Error: unknown command "${command}".`);
+    printUsage();
+    process.exit(1);
+}
+const isMain = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    pathToFileURL(process.argv[1]).href === import.meta.url;
+if (isMain) {
+    main().catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}

package/dist/index.d.ts

@@ -1,55 +1,7 @@
 import type { EwynOptions, EwynOptionsTyped, SendEmailOptions, SendEmailOptionsTyped, SendEmailResponse, TemplateConfig } from './types.js';
-/**
- * Ewyn SDK Client
- *
- * @example Basic usage without template config
- * ```ts
- * const client = new Ewyn({
- *   workspaceId: 'your-workspace-id',
- *   apiKey: 'your-api-key',
- * });
- *
- * await client.send({
- *   to: 'user@example.com',
- *   templateId: 'version-uuid',
- *   variables: { firstName: 'John' }
- * });
- * ```
- *
- * @example Type-safe usage with template config
- * ```ts
- * const config = {
- *   welcome: {
- *     id: 'version-uuid',
- *     name: 'Welcome Email',
- *     version: 1,
- *     vars: {
- *       firstName: { required: true },
- *       plan: { required: false }
- *     }
- *   }
- * } as const;
- *
- * const client = new Ewyn({
- *   workspaceId: 'your-workspace-id',
- *   apiKey: 'your-api-key',
- *   templates: config
- * });
- *
- * // Type-safe sending
- * await client.send({
- *   to: 'user@example.com',
- *   template: 'welcome',  // Autocomplete available
- *   variables: {
- *     firstName: 'John'    // TypeScript enforces required vars
- *   }
- * });
- * ```
- */
 export declare class Ewyn<TConfig extends TemplateConfig = TemplateConfig> {
     private readonly workspaceId;
     private readonly apiKey;
-    private readonly baseUrl;
     private readonly templates?;
     private readonly maxRetries;
     private readonly timeout;
@@ -95,5 +47,5 @@ export declare class Ewyn<TConfig extends TemplateConfig = TemplateConfig> {
     private requestWithRetry;
 }
 export { EwynApiError } from './errors.js';
-export type { EwynOptions, EwynOptionsTyped, SendEmailOptions, SendEmailOptionsBase, SendEmailOptionsTyped, SendEmailResponse, TemplateConfig, TemplateConfigEntry, TemplateVariable, } from './types.js';
+export type { EwynFetchConfig, EwynOptions, EwynOptionsTyped, SendEmailOptions, SendEmailOptionsBase, SendEmailOptionsTyped, SendEmailResponse, TemplateConfig, TemplateConfigEntry, TemplateVariable } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,IAAI,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAS5D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,IAAI,CACR,OAAO,EAAE,OAAO,SAAS,cAAc,GACnC,qBAAqB,CAAC,OAAO,CAAC,GAAG,gBAAgB,GACjD,gBAAgB,GACnB,OAAO,CAAC,iBAAiB,CAAC;IA8C7B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;YACW,gBAAgB;CAuE/B;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAmDpB,qBAAa,IAAI,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAQ5D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,IAAI,CACR,OAAO,EAAE,OAAO,SAAS,cAAc,GACnC,qBAAqB,CAAC,OAAO,CAAC,GAAG,gBAAgB,GACjD,gBAAgB,GACnB,OAAO,CAAC,iBAAiB,CAAC;IA8C7B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;YACW,gBAAgB;CAuE/B;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -46,17 +46,16 @@ import { EwynApiError } from './errors.js';
  * });
  * ```
  */
+const EWYN_API_BASE_URL = 'https://www.ewyn.ai/api/v1';
 export class Ewyn {
     workspaceId;
     apiKey;
-    baseUrl;
     templates;
     maxRetries;
     timeout;
     constructor(options) {
         this.workspaceId = options.workspaceId;
         this.apiKey = options.apiKey;
-        this.baseUrl = options.baseUrl || 'https://www.ewyn.ai/api/v1';
         this.templates = options.templates;
         this.maxRetries = options.maxRetries ?? 3;
         this.timeout = options.timeout ?? 30000;
@@ -166,7 +165,7 @@ export class Ewyn {
      * Make HTTP request with retry logic
      */
     async requestWithRetry(path, init, attempt = 1) {
-        const url = `${this.baseUrl}${path}`;
+        const url = `${EWYN_API_BASE_URL}${path}`;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         try {

package/dist/types.d.ts

@@ -104,8 +104,6 @@ export interface EwynOptionsBase {
     workspaceId: string;
     /** API key secret */
     apiKey: string;
-    /** Base URL for the API (defaults to production) */
-    baseUrl?: string;
     /** Maximum number of retries for retryable errors (default: 3) */
     maxRetries?: number;
     /** Request timeout in milliseconds (default: 30000) */
@@ -125,5 +123,17 @@ export type EwynOptions = EwynOptionsBase & {
     /** Template configuration for name-based sending and validation */
     templates?: TemplateConfig;
 };
+/**
+ * Configuration for the fetch-config CLI (ewyn.config.ts).
+ * Used only by the CLI to know which workspace/API key to use and where to write the generated file.
+ */
+export interface EwynFetchConfig {
+    /** Workspace ID (UUID) */
+    workspaceId: string;
+    /** API key secret (e.g. process.env.EWYN_API_KEY) */
+    apiKey: string;
+    /** Output path for the generated ewynTemplates file (e.g. ./src/ewynTemplates.ts). If omitted, defaults to ./ewynTemplates.ts in cwd. */
+    configurationPath?: string;
+}
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ewyn/client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official TypeScript SDK for Ewyn email service with full type safety",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,9 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "bin": {
+    "ewyn": "./dist/cli.js"
+  },
   "files": [
     "dist"
   ],
@@ -35,7 +38,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {},
+  "dependencies": {
+    "tsx": "^4.19.0"
+  },
   "devDependencies": {
     "@types/node": "^20.11.0",
     "@workspace/eslint-config": "workspace:*",