kugelaudio 0.3.0 → 0.5.0

package/dist/index.js

@@ -22,10 +22,13 @@ var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
   ConnectionError: () => ConnectionError,
+  DictionariesResource: () => DictionariesResource,
+  DictionaryEntriesResource: () => DictionaryEntriesResource,
   ErrorCodes: () => ErrorCodes,
   InsufficientCreditsError: () => InsufficientCreditsError,
   KugelAudio: () => KugelAudio,
   KugelAudioError: () => KugelAudioError,
+  NotFoundError: () => NotFoundError,
   RateLimitError: () => RateLimitError,
   ValidationError: () => ValidationError,
   WsCloseCodes: () => WsCloseCodes,
@@ -40,6 +43,187 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/dictionaries.ts
+function mapDictionary(raw) {
+  return {
+    id: raw.id,
+    projectId: raw.project_id,
+    name: raw.name,
+    description: raw.description ?? void 0,
+    language: raw.language ?? void 0,
+    isActive: raw.is_active ?? true,
+    createdAt: raw.created_at,
+    updatedAt: raw.updated_at
+  };
+}
+function mapEntry(raw) {
+  return {
+    id: raw.id,
+    dictionaryId: raw.dictionary_id,
+    word: raw.word,
+    replacement: raw.replacement,
+    ipa: raw.ipa ?? void 0,
+    caseSensitive: raw.case_sensitive ?? false,
+    createdAt: raw.created_at,
+    updatedAt: raw.updated_at
+  };
+}
+function entryPayload(input) {
+  const payload = {
+    word: input.word,
+    replacement: input.replacement
+  };
+  if (input.ipa !== void 0) payload.ipa = input.ipa;
+  if (input.caseSensitive !== void 0) {
+    payload.case_sensitive = input.caseSensitive;
+  }
+  return payload;
+}
+function buildPath(base, params) {
+  const search = new URLSearchParams();
+  for (const [key, val] of Object.entries(params)) {
+    if (val === void 0 || val === null) continue;
+    search.set(key, String(val));
+  }
+  const query = search.toString();
+  return query ? `${base}?${query}` : base;
+}
+var DictionaryEntriesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List entries with optional search + pagination. */
+  async list(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      search: options?.search,
+      limit: options?.limit,
+      offset: options?.offset,
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return {
+      entries: raw.entries.map(mapEntry),
+      total: raw.total,
+      limit: raw.limit,
+      offset: raw.offset
+    };
+  }
+  /** Add a single entry to a dictionary. */
+  async add(dictionaryId, entry, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "POST",
+      path,
+      entryPayload(entry)
+    );
+    return mapEntry(raw);
+  }
+  /** Update an existing entry. */
+  async update(dictionaryId, entryId, updates, options) {
+    const payload = {};
+    if (updates.word !== void 0) payload.word = updates.word;
+    if (updates.replacement !== void 0) payload.replacement = updates.replacement;
+    if (updates.ipa !== void 0) payload.ipa = updates.ipa;
+    if (updates.caseSensitive !== void 0) {
+      payload.case_sensitive = updates.caseSensitive;
+    }
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries/${entryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "PATCH",
+      path,
+      payload
+    );
+    return mapEntry(raw);
+  }
+  /** Delete a single entry. */
+  async delete(dictionaryId, entryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries/${entryId}`, {
+      project_id: options?.projectId
+    });
+    await this.client.request("DELETE", path);
+  }
+  /**
+   * Replace every entry in the dictionary atomically.
+   *
+   * Each item must have ``word`` and ``replacement``; existing entries
+   * whose ``word`` is not in the supplied list are deleted. Idempotent.
+   */
+  async replaceAll(dictionaryId, entries, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("PUT", path, {
+      entries: entries.map(entryPayload)
+    });
+    return raw;
+  }
+};
+var DictionariesResource = class {
+  constructor(client) {
+    this.client = client;
+    this.entries = new DictionaryEntriesResource(client);
+  }
+  /** List every dictionary in the caller's project. */
+  async list(options) {
+    const path = buildPath("/v1/dictionaries", {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return raw.dictionaries.map(mapDictionary);
+  }
+  /** Create a new dictionary scoped to the caller's project. */
+  async create(body, options) {
+    const path = buildPath("/v1/dictionaries", {
+      project_id: options?.projectId
+    });
+    const payload = { name: body.name };
+    if (body.description !== void 0) payload.description = body.description;
+    if (body.language !== void 0) payload.language = body.language;
+    const raw = await this.client.request(
+      "POST",
+      path,
+      payload
+    );
+    return mapDictionary(raw);
+  }
+  /** Fetch a single dictionary. */
+  async get(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return mapDictionary(raw);
+  }
+  /** Update name / description / language / isActive. */
+  async update(dictionaryId, updates, options) {
+    const payload = {};
+    if (updates.name !== void 0) payload.name = updates.name;
+    if (updates.description !== void 0) payload.description = updates.description;
+    if (updates.language !== void 0) payload.language = updates.language;
+    if (updates.isActive !== void 0) payload.is_active = updates.isActive;
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "PATCH",
+      path,
+      payload
+    );
+    return mapDictionary(raw);
+  }
+  /** Delete a dictionary (cascades to its entries). */
+  async delete(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    await this.client.request("DELETE", path);
+  }
+};
+
 // src/errors.ts
 var ErrorCodes = {
   UNAUTHORIZED: "UNAUTHORIZED",
@@ -112,6 +296,17 @@ var ConnectionError = class _ConnectionError extends KugelAudioError {
     Object.setPrototypeOf(this, _ConnectionError.prototype);
   }
 };
+var NotFoundError = class _NotFoundError extends KugelAudioError {
+  constructor(message, options = {}) {
+    super(message ?? "Not found.", {
+      statusCode: 404,
+      errorCode: ErrorCodes.NOT_FOUND,
+      ...options
+    });
+    this.name = "NotFoundError";
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+};
 function build(status, errorCode, message, opts = {}) {
   const common = { ...opts };
   if (status !== void 0) common.statusCode = status;
@@ -135,6 +330,9 @@ function build(status, errorCode, message, opts = {}) {
       common
     );
   }
+  if (errorCode === ErrorCodes.NOT_FOUND || status === 404) {
+    return new NotFoundError(message || void 0, common);
+  }
   return new KugelAudioError(message || `HTTP ${status}`, common);
 }
 function readHeader(headers, name) {
@@ -312,11 +510,9 @@ function getWebSocket() {
 }
 
 // src/client.ts
-var REGION_URLS = {
-  eu: "https://api.kugelaudio.com",
-  us: "https://us-api.kugelaudio.com",
-  global: "https://global-api.kugelaudio.com"
-};
+var DEFAULT_API_URL = "https://api.kugelaudio.com";
+var EU_API_URL = "https://api.eu.kugelaudio.com";
+var SUPPORTED_REGIONS = ["eu", "us", "global"];
 var REGION_PREFIXES = ["eu-", "us-", "global-"];
 function parseApiKey(apiKey) {
   for (const prefix of REGION_PREFIXES) {
@@ -1539,19 +1735,23 @@ var KugelAudio = class _KugelAudio {
     if (options.apiUrl) {
       this._apiUrl = options.apiUrl.replace(/\/$/, "");
     } else {
-      const effectiveRegion = options.region || detectedRegion || "eu";
-      if (!(effectiveRegion in REGION_URLS)) {
+      const effectiveRegion = options.region || detectedRegion;
+      if (!effectiveRegion) {
+        this._apiUrl = DEFAULT_API_URL;
+      } else if (!SUPPORTED_REGIONS.includes(effectiveRegion)) {
         throw new ValidationError(
-          `Invalid region '${effectiveRegion}'. Must be one of: ${Object.keys(REGION_URLS).join(", ")}.`
+          `Invalid region '${effectiveRegion}'. Must be one of: ${SUPPORTED_REGIONS.join(", ")}.`
         );
+      } else {
+        this._apiUrl = effectiveRegion === "eu" ? EU_API_URL : DEFAULT_API_URL;
       }
-      this._apiUrl = REGION_URLS[effectiveRegion];
     }
     this._ttsUrl = (options.ttsUrl || this._apiUrl).replace(/\/$/, "");
     this._timeout = options.timeout || 6e4;
     this._keepalivePingInterval = options.keepalivePingInterval !== void 0 ? options.keepalivePingInterval : 2e4;
     this.models = new ModelsResource(this);
     this.voices = new VoicesResource(this);
+    this.dictionaries = new DictionariesResource(this);
     this.tts = new TTSResource(this);
   }
   /**
@@ -1718,10 +1918,13 @@ var KugelAudio = class _KugelAudio {
 0 && (module.exports = {
   AuthenticationError,
   ConnectionError,
+  DictionariesResource,
+  DictionaryEntriesResource,
   ErrorCodes,
   InsufficientCreditsError,
   KugelAudio,
   KugelAudioError,
+  NotFoundError,
   RateLimitError,
   ValidationError,
   WsCloseCodes,

package/dist/index.mjs

@@ -5,6 +5,187 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// src/dictionaries.ts
+function mapDictionary(raw) {
+  return {
+    id: raw.id,
+    projectId: raw.project_id,
+    name: raw.name,
+    description: raw.description ?? void 0,
+    language: raw.language ?? void 0,
+    isActive: raw.is_active ?? true,
+    createdAt: raw.created_at,
+    updatedAt: raw.updated_at
+  };
+}
+function mapEntry(raw) {
+  return {
+    id: raw.id,
+    dictionaryId: raw.dictionary_id,
+    word: raw.word,
+    replacement: raw.replacement,
+    ipa: raw.ipa ?? void 0,
+    caseSensitive: raw.case_sensitive ?? false,
+    createdAt: raw.created_at,
+    updatedAt: raw.updated_at
+  };
+}
+function entryPayload(input) {
+  const payload = {
+    word: input.word,
+    replacement: input.replacement
+  };
+  if (input.ipa !== void 0) payload.ipa = input.ipa;
+  if (input.caseSensitive !== void 0) {
+    payload.case_sensitive = input.caseSensitive;
+  }
+  return payload;
+}
+function buildPath(base, params) {
+  const search = new URLSearchParams();
+  for (const [key, val] of Object.entries(params)) {
+    if (val === void 0 || val === null) continue;
+    search.set(key, String(val));
+  }
+  const query = search.toString();
+  return query ? `${base}?${query}` : base;
+}
+var DictionaryEntriesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List entries with optional search + pagination. */
+  async list(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      search: options?.search,
+      limit: options?.limit,
+      offset: options?.offset,
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return {
+      entries: raw.entries.map(mapEntry),
+      total: raw.total,
+      limit: raw.limit,
+      offset: raw.offset
+    };
+  }
+  /** Add a single entry to a dictionary. */
+  async add(dictionaryId, entry, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "POST",
+      path,
+      entryPayload(entry)
+    );
+    return mapEntry(raw);
+  }
+  /** Update an existing entry. */
+  async update(dictionaryId, entryId, updates, options) {
+    const payload = {};
+    if (updates.word !== void 0) payload.word = updates.word;
+    if (updates.replacement !== void 0) payload.replacement = updates.replacement;
+    if (updates.ipa !== void 0) payload.ipa = updates.ipa;
+    if (updates.caseSensitive !== void 0) {
+      payload.case_sensitive = updates.caseSensitive;
+    }
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries/${entryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "PATCH",
+      path,
+      payload
+    );
+    return mapEntry(raw);
+  }
+  /** Delete a single entry. */
+  async delete(dictionaryId, entryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries/${entryId}`, {
+      project_id: options?.projectId
+    });
+    await this.client.request("DELETE", path);
+  }
+  /**
+   * Replace every entry in the dictionary atomically.
+   *
+   * Each item must have ``word`` and ``replacement``; existing entries
+   * whose ``word`` is not in the supplied list are deleted. Idempotent.
+   */
+  async replaceAll(dictionaryId, entries, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}/entries`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("PUT", path, {
+      entries: entries.map(entryPayload)
+    });
+    return raw;
+  }
+};
+var DictionariesResource = class {
+  constructor(client) {
+    this.client = client;
+    this.entries = new DictionaryEntriesResource(client);
+  }
+  /** List every dictionary in the caller's project. */
+  async list(options) {
+    const path = buildPath("/v1/dictionaries", {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return raw.dictionaries.map(mapDictionary);
+  }
+  /** Create a new dictionary scoped to the caller's project. */
+  async create(body, options) {
+    const path = buildPath("/v1/dictionaries", {
+      project_id: options?.projectId
+    });
+    const payload = { name: body.name };
+    if (body.description !== void 0) payload.description = body.description;
+    if (body.language !== void 0) payload.language = body.language;
+    const raw = await this.client.request(
+      "POST",
+      path,
+      payload
+    );
+    return mapDictionary(raw);
+  }
+  /** Fetch a single dictionary. */
+  async get(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request("GET", path);
+    return mapDictionary(raw);
+  }
+  /** Update name / description / language / isActive. */
+  async update(dictionaryId, updates, options) {
+    const payload = {};
+    if (updates.name !== void 0) payload.name = updates.name;
+    if (updates.description !== void 0) payload.description = updates.description;
+    if (updates.language !== void 0) payload.language = updates.language;
+    if (updates.isActive !== void 0) payload.is_active = updates.isActive;
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    const raw = await this.client.request(
+      "PATCH",
+      path,
+      payload
+    );
+    return mapDictionary(raw);
+  }
+  /** Delete a dictionary (cascades to its entries). */
+  async delete(dictionaryId, options) {
+    const path = buildPath(`/v1/dictionaries/${dictionaryId}`, {
+      project_id: options?.projectId
+    });
+    await this.client.request("DELETE", path);
+  }
+};
+
 // src/errors.ts
 var ErrorCodes = {
   UNAUTHORIZED: "UNAUTHORIZED",
@@ -77,6 +258,17 @@ var ConnectionError = class _ConnectionError extends KugelAudioError {
     Object.setPrototypeOf(this, _ConnectionError.prototype);
   }
 };
+var NotFoundError = class _NotFoundError extends KugelAudioError {
+  constructor(message, options = {}) {
+    super(message ?? "Not found.", {
+      statusCode: 404,
+      errorCode: ErrorCodes.NOT_FOUND,
+      ...options
+    });
+    this.name = "NotFoundError";
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+};
 function build(status, errorCode, message, opts = {}) {
   const common = { ...opts };
   if (status !== void 0) common.statusCode = status;
@@ -100,6 +292,9 @@ function build(status, errorCode, message, opts = {}) {
       common
     );
   }
+  if (errorCode === ErrorCodes.NOT_FOUND || status === 404) {
+    return new NotFoundError(message || void 0, common);
+  }
   return new KugelAudioError(message || `HTTP ${status}`, common);
 }
 function readHeader(headers, name) {
@@ -277,11 +472,9 @@ function getWebSocket() {
 }
 
 // src/client.ts
-var REGION_URLS = {
-  eu: "https://api.kugelaudio.com",
-  us: "https://us-api.kugelaudio.com",
-  global: "https://global-api.kugelaudio.com"
-};
+var DEFAULT_API_URL = "https://api.kugelaudio.com";
+var EU_API_URL = "https://api.eu.kugelaudio.com";
+var SUPPORTED_REGIONS = ["eu", "us", "global"];
 var REGION_PREFIXES = ["eu-", "us-", "global-"];
 function parseApiKey(apiKey) {
   for (const prefix of REGION_PREFIXES) {
@@ -1504,19 +1697,23 @@ var KugelAudio = class _KugelAudio {
     if (options.apiUrl) {
       this._apiUrl = options.apiUrl.replace(/\/$/, "");
     } else {
-      const effectiveRegion = options.region || detectedRegion || "eu";
-      if (!(effectiveRegion in REGION_URLS)) {
+      const effectiveRegion = options.region || detectedRegion;
+      if (!effectiveRegion) {
+        this._apiUrl = DEFAULT_API_URL;
+      } else if (!SUPPORTED_REGIONS.includes(effectiveRegion)) {
         throw new ValidationError(
-          `Invalid region '${effectiveRegion}'. Must be one of: ${Object.keys(REGION_URLS).join(", ")}.`
+          `Invalid region '${effectiveRegion}'. Must be one of: ${SUPPORTED_REGIONS.join(", ")}.`
         );
+      } else {
+        this._apiUrl = effectiveRegion === "eu" ? EU_API_URL : DEFAULT_API_URL;
       }
-      this._apiUrl = REGION_URLS[effectiveRegion];
     }
     this._ttsUrl = (options.ttsUrl || this._apiUrl).replace(/\/$/, "");
     this._timeout = options.timeout || 6e4;
     this._keepalivePingInterval = options.keepalivePingInterval !== void 0 ? options.keepalivePingInterval : 2e4;
     this.models = new ModelsResource(this);
     this.voices = new VoicesResource(this);
+    this.dictionaries = new DictionariesResource(this);
     this.tts = new TTSResource(this);
   }
   /**
@@ -1682,10 +1879,13 @@ var KugelAudio = class _KugelAudio {
 export {
   AuthenticationError,
   ConnectionError,
+  DictionariesResource,
+  DictionaryEntriesResource,
   ErrorCodes,
   InsufficientCreditsError,
   KugelAudio,
   KugelAudioError,
+  NotFoundError,
   RateLimitError,
   ValidationError,
   WsCloseCodes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kugelaudio",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -58,4 +58,4 @@
     "tsx": "^4.21.0",
     "ws": "^8.18.0"
   }
-}
+}

package/src/client.test.ts

@@ -180,42 +180,42 @@ describe('TTSResource.toReadable()', () => {
 // ---------------------------------------------------------------------------
 
 describe('KugelAudio multi-region', () => {
-  it('defaults to EU when no region or prefix is given', () => {
+  it('uses canonical API when no region or prefix is given', () => {
     const client = new KugelAudio({ apiKey: 'ka_test123' });
     expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
   });
 
-  it('selects US endpoint with explicit region', () => {
+  it('selects canonical endpoint with explicit region', () => {
     const client = new KugelAudio({ apiKey: 'ka_test123', region: 'us' });
-    expect((client as any)._apiUrl).toBe('https://us-api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
   });
 
   it('selects global endpoint with explicit region', () => {
     const client = new KugelAudio({ apiKey: 'ka_test123', region: 'global' });
-    expect((client as any)._apiUrl).toBe('https://global-api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
   });
 
-  it('detects US region from key prefix and strips it', () => {
+  it('detects canonical route from key prefix and strips it', () => {
     const client = new KugelAudio({ apiKey: 'us-ka_test123' });
-    expect((client as any)._apiUrl).toBe('https://us-api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
     expect((client as any)._apiKey).toBe('ka_test123');
   });
 
   it('detects global region from key prefix and strips it', () => {
     const client = new KugelAudio({ apiKey: 'global-ka_test123' });
-    expect((client as any)._apiUrl).toBe('https://global-api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
     expect((client as any)._apiKey).toBe('ka_test123');
   });
 
   it('detects EU region from key prefix and strips it', () => {
     const client = new KugelAudio({ apiKey: 'eu-ka_test123' });
-    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.eu.kugelaudio.com');
     expect((client as any)._apiKey).toBe('ka_test123');
   });
 
   it('explicit region overrides key prefix', () => {
     const client = new KugelAudio({ apiKey: 'us-ka_test123', region: 'global' });
-    expect((client as any)._apiUrl).toBe('https://global-api.kugelaudio.com');
+    expect((client as any)._apiUrl).toBe('https://api.kugelaudio.com');
     expect((client as any)._apiKey).toBe('ka_test123');
   });
 
@@ -237,7 +237,7 @@ describe('KugelAudio multi-region', () => {
 
   it('ttsUrl defaults to the resolved region URL', () => {
     const client = new KugelAudio({ apiKey: 'us-ka_test123' });
-    expect((client as any)._ttsUrl).toBe('https://us-api.kugelaudio.com');
+    expect((client as any)._ttsUrl).toBe('https://api.kugelaudio.com');
   });
 
   it('unprefixed key is not modified', () => {

package/src/client.ts

@@ -2,6 +2,7 @@
  * KugelAudio API Client.
  */
 
+import { DictionariesResource } from './dictionaries';
 import {
     ConnectionError,
     KugelAudioError,
@@ -33,11 +34,9 @@ import { getWebSocket } from './websocket';
 
 import type { Region } from './types';
 
-const REGION_URLS: Record<Region, string> = {
-  eu: 'https://api.kugelaudio.com',
-  us: 'https://us-api.kugelaudio.com',
-  global: 'https://global-api.kugelaudio.com',
-};
+const DEFAULT_API_URL = 'https://api.kugelaudio.com';
+const EU_API_URL = 'https://api.eu.kugelaudio.com';
+const SUPPORTED_REGIONS = ['eu', 'us', 'global'] as const;
 
 const REGION_PREFIXES = ['eu-', 'us-', 'global-'] as const;
 
@@ -1616,6 +1615,8 @@ export class KugelAudio {
   public readonly models: ModelsResource;
   /** Voices resource */
   public readonly voices: VoicesResource;
+  /** Custom dictionaries resource */
+  public readonly dictionaries: DictionariesResource;
   /** TTS resource */
   public readonly tts: TTSResource;
 
@@ -1637,13 +1638,16 @@ export class KugelAudio {
     if (options.apiUrl) {
       this._apiUrl = options.apiUrl.replace(/\/$/, '');
     } else {
-      const effectiveRegion = options.region || detectedRegion || 'eu';
-      if (!(effectiveRegion in REGION_URLS)) {
+      const effectiveRegion = options.region || detectedRegion;
+      if (!effectiveRegion) {
+        this._apiUrl = DEFAULT_API_URL;
+      } else if (!SUPPORTED_REGIONS.includes(effectiveRegion as Region)) {
         throw new ValidationError(
-          `Invalid region '${effectiveRegion}'. Must be one of: ${Object.keys(REGION_URLS).join(', ')}.`,
+          `Invalid region '${effectiveRegion}'. Must be one of: ${SUPPORTED_REGIONS.join(', ')}.`,
         );
+      } else {
+        this._apiUrl = effectiveRegion === 'eu' ? EU_API_URL : DEFAULT_API_URL;
       }
-      this._apiUrl = REGION_URLS[effectiveRegion as Region];
     }
 
     // If ttsUrl not specified, use apiUrl (backend proxies to TTS server)
@@ -1655,6 +1659,7 @@ export class KugelAudio {
 
     this.models = new ModelsResource(this);
     this.voices = new VoicesResource(this);
+    this.dictionaries = new DictionariesResource(this);
     this.tts = new TTSResource(this);
   }
 
@@ -1843,4 +1848,3 @@ export class KugelAudio {
     }
   }
 }
-