kugelaudio 0.4.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) {
@@ -1553,6 +1751,7 @@ var KugelAudio = class _KugelAudio {
     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);
   }
   /**
@@ -1719,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) {
@@ -1518,6 +1713,7 @@ var KugelAudio = class _KugelAudio {
     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);
   }
   /**
@@ -1683,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.4.0",
+  "version": "0.5.0",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client.ts

@@ -2,6 +2,7 @@
  * KugelAudio API Client.
  */
 
+import { DictionariesResource } from './dictionaries';
 import {
     ConnectionError,
     KugelAudioError,
@@ -1614,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;
 
@@ -1656,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);
   }