kugelaudio 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [kugelaudio-v0.6.1](https://github.com/Kugelaudio/KugelAudio/compare/js-sdk-v0.6.0...js-sdk-v0.6.1) (2026-06-04)
+
+### Bug Fixes
+
+* **python-sdk:** propagate ingress errors through SDK integrations ([#1313](https://github.com/Kugelaudio/KugelAudio/issues/1313)) ([3ae2e03](https://github.com/Kugelaudio/KugelAudio/commit/3ae2e03745b49cca0712c20d9a658c160f4b6f38))
+
 ## [kugelaudio-v0.6.0](https://github.com/Kugelaudio/KugelAudio/compare/js-sdk-v0.5.0...js-sdk-v0.6.0) (2026-06-01)
 
 ### Features

package/dist/index.d.mts

@@ -1224,6 +1224,8 @@ declare const ErrorCodes: {
     readonly VALIDATION: "VALIDATION_ERROR";
     readonly INTERNAL: "INTERNAL_ERROR";
     readonly NOT_FOUND: "NOT_FOUND";
+    readonly MISSING_VOICE_ID: "MISSING_VOICE_ID";
+    readonly TOO_MANY_CONTEXTS: "TOO_MANY_CONTEXTS";
 };
 type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
 declare const WsCloseCodes: {
@@ -1305,11 +1307,12 @@ interface HttpResponseLike {
 declare function classifyHttpError(status: number, bodyText: string, headers: HttpResponseLike['headers']): KugelAudioError;
 /**
  * Build a `KugelAudioError` from a server-sent WebSocket error frame
- * (`{error, error_code, retry_after}`).
+ * (`{error, error_code, code}`).
  */
 declare function classifyWsFrame(data: {
     error?: string;
     error_code?: string;
+    code?: number;
     retry_after?: number;
 }): KugelAudioError;
 /**

package/dist/index.d.ts

@@ -1224,6 +1224,8 @@ declare const ErrorCodes: {
     readonly VALIDATION: "VALIDATION_ERROR";
     readonly INTERNAL: "INTERNAL_ERROR";
     readonly NOT_FOUND: "NOT_FOUND";
+    readonly MISSING_VOICE_ID: "MISSING_VOICE_ID";
+    readonly TOO_MANY_CONTEXTS: "TOO_MANY_CONTEXTS";
 };
 type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
 declare const WsCloseCodes: {
@@ -1305,11 +1307,12 @@ interface HttpResponseLike {
 declare function classifyHttpError(status: number, bodyText: string, headers: HttpResponseLike['headers']): KugelAudioError;
 /**
  * Build a `KugelAudioError` from a server-sent WebSocket error frame
- * (`{error, error_code, retry_after}`).
+ * (`{error, error_code, code}`).
  */
 declare function classifyWsFrame(data: {
     error?: string;
     error_code?: string;
+    code?: number;
     retry_after?: number;
 }): KugelAudioError;
 /**

package/dist/index.js

@@ -233,7 +233,9 @@ var ErrorCodes = {
   EMPTY_AUDIO: "EMPTY_AUDIO",
   VALIDATION: "VALIDATION_ERROR",
   INTERNAL: "INTERNAL_ERROR",
-  NOT_FOUND: "NOT_FOUND"
+  NOT_FOUND: "NOT_FOUND",
+  MISSING_VOICE_ID: "MISSING_VOICE_ID",
+  TOO_MANY_CONTEXTS: "TOO_MANY_CONTEXTS"
 };
 var WsCloseCodes = {
   UNAUTHORIZED: 4001,
@@ -317,10 +319,10 @@ function build(status, errorCode, message, opts = {}) {
   if (errorCode === ErrorCodes.INSUFFICIENT_CREDITS || status === 402) {
     return new InsufficientCreditsError(message || void 0, common);
   }
-  if (errorCode === ErrorCodes.RATE_LIMITED || status === 429) {
+  if (errorCode === ErrorCodes.RATE_LIMITED || errorCode === ErrorCodes.TOO_MANY_CONTEXTS || status === 429) {
     return new RateLimitError(message || void 0, common);
   }
-  if (errorCode === ErrorCodes.VALIDATION || status === 400) {
+  if (errorCode === ErrorCodes.VALIDATION || errorCode === ErrorCodes.MISSING_VOICE_ID || status === 400) {
     return new ValidationError(message || "Request validation failed.", common);
   }
   if (errorCode === ErrorCodes.MODEL_UNAVAILABLE || status === 503) {
@@ -380,8 +382,9 @@ function classifyHttpError(status, bodyText, headers) {
 function classifyWsFrame(data) {
   const errorCode = data.error_code;
   const message = data.error ?? "Server reported an error.";
+  const status = typeof data.code === "number" ? data.code : void 0;
   const retryAfter = typeof data.retry_after === "number" ? data.retry_after : void 0;
-  return build(void 0, errorCode, message, { retryAfter });
+  return build(status, errorCode, message, { retryAfter });
 }
 function classifyWsClose(code, reason) {
   const reasonTxt = (reason ?? "").trim();
@@ -1303,7 +1306,7 @@ var MultiContextSession = class {
         const data = JSON.parse(messageData);
         if (data.error) {
           this.callbacks.onError?.(
-            new KugelAudioError(data.error),
+            classifyWsFrame(data),
             data.context_id
           );
           return;

package/dist/index.mjs

@@ -195,7 +195,9 @@ var ErrorCodes = {
   EMPTY_AUDIO: "EMPTY_AUDIO",
   VALIDATION: "VALIDATION_ERROR",
   INTERNAL: "INTERNAL_ERROR",
-  NOT_FOUND: "NOT_FOUND"
+  NOT_FOUND: "NOT_FOUND",
+  MISSING_VOICE_ID: "MISSING_VOICE_ID",
+  TOO_MANY_CONTEXTS: "TOO_MANY_CONTEXTS"
 };
 var WsCloseCodes = {
   UNAUTHORIZED: 4001,
@@ -279,10 +281,10 @@ function build(status, errorCode, message, opts = {}) {
   if (errorCode === ErrorCodes.INSUFFICIENT_CREDITS || status === 402) {
     return new InsufficientCreditsError(message || void 0, common);
   }
-  if (errorCode === ErrorCodes.RATE_LIMITED || status === 429) {
+  if (errorCode === ErrorCodes.RATE_LIMITED || errorCode === ErrorCodes.TOO_MANY_CONTEXTS || status === 429) {
     return new RateLimitError(message || void 0, common);
   }
-  if (errorCode === ErrorCodes.VALIDATION || status === 400) {
+  if (errorCode === ErrorCodes.VALIDATION || errorCode === ErrorCodes.MISSING_VOICE_ID || status === 400) {
     return new ValidationError(message || "Request validation failed.", common);
   }
   if (errorCode === ErrorCodes.MODEL_UNAVAILABLE || status === 503) {
@@ -342,8 +344,9 @@ function classifyHttpError(status, bodyText, headers) {
 function classifyWsFrame(data) {
   const errorCode = data.error_code;
   const message = data.error ?? "Server reported an error.";
+  const status = typeof data.code === "number" ? data.code : void 0;
   const retryAfter = typeof data.retry_after === "number" ? data.retry_after : void 0;
-  return build(void 0, errorCode, message, { retryAfter });
+  return build(status, errorCode, message, { retryAfter });
 }
 function classifyWsClose(code, reason) {
   const reasonTxt = (reason ?? "").trim();
@@ -1265,7 +1268,7 @@ var MultiContextSession = class {
         const data = JSON.parse(messageData);
         if (data.error) {
           this.callbacks.onError?.(
-            new KugelAudioError(data.error),
+            classifyWsFrame(data),
             data.context_id
           );
           return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kugelaudio",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client.test.ts

@@ -8,6 +8,7 @@
 
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { KugelAudio } from './client';
+import { RateLimitError } from './errors';
 
 // ---------------------------------------------------------------------------
 // Minimal WebSocket mock
@@ -660,4 +661,27 @@ describe('MultiContextSession closeContext', () => {
     expect(sent.close_context).toBe(true);
     expect(sent.immediate).toBeUndefined();
   });
+
+  it('maps ingress context-cap errors to typed callback errors', async () => {
+    const errors: Array<{ contextId?: string; error: Error }> = [];
+    const session = client.tts.createMultiContextSession({ defaultVoiceId: 1 });
+    await session.connect({
+      onError: (error, contextId) => errors.push({ contextId, error }),
+    });
+
+    mockWs.onmessage?.({
+      data: JSON.stringify({
+        error: 'Too many concurrent contexts',
+        error_code: 'TOO_MANY_CONTEXTS',
+        code: 429,
+        context_id: 'ctx1',
+      }),
+    });
+
+    expect(errors).toHaveLength(1);
+    expect(errors[0].contextId).toBe('ctx1');
+    expect(errors[0].error).toBeInstanceOf(RateLimitError);
+    expect((errors[0].error as RateLimitError).statusCode).toBe(429);
+    expect((errors[0].error as RateLimitError).errorCode).toBe('TOO_MANY_CONTEXTS');
+  });
 });

package/src/client.ts

@@ -873,7 +873,7 @@ class TTSResource {
     }
   }
 
-  private parseError(data: { error?: string; error_code?: string; retry_after?: number }): Error {
+  private parseError(data: { error?: string; error_code?: string; code?: number; retry_after?: number }): Error {
     return classifyWsFrame(data);
   }
 
@@ -1019,7 +1019,7 @@ class MultiContextSession {
 
         if (data.error) {
           this.callbacks.onError?.(
-            new KugelAudioError(data.error),
+            classifyWsFrame(data),
             data.context_id
           );
           return;

package/src/errors.ts

@@ -17,6 +17,8 @@ export const ErrorCodes = {
   VALIDATION: 'VALIDATION_ERROR',
   INTERNAL: 'INTERNAL_ERROR',
   NOT_FOUND: 'NOT_FOUND',
+  MISSING_VOICE_ID: 'MISSING_VOICE_ID',
+  TOO_MANY_CONTEXTS: 'TOO_MANY_CONTEXTS',
 } as const;
 export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
 
@@ -175,10 +177,18 @@ function build(
   if (errorCode === ErrorCodes.INSUFFICIENT_CREDITS || status === 402) {
     return new InsufficientCreditsError(message || undefined, common);
   }
-  if (errorCode === ErrorCodes.RATE_LIMITED || status === 429) {
+  if (
+    errorCode === ErrorCodes.RATE_LIMITED ||
+    errorCode === ErrorCodes.TOO_MANY_CONTEXTS ||
+    status === 429
+  ) {
     return new RateLimitError(message || undefined, common);
   }
-  if (errorCode === ErrorCodes.VALIDATION || status === 400) {
+  if (
+    errorCode === ErrorCodes.VALIDATION ||
+    errorCode === ErrorCodes.MISSING_VOICE_ID ||
+    status === 400
+  ) {
     return new ValidationError(message || 'Request validation failed.', common);
   }
   if (errorCode === ErrorCodes.MODEL_UNAVAILABLE || status === 503) {
@@ -263,17 +273,19 @@ export function classifyHttpError(
 
 /**
  * Build a `KugelAudioError` from a server-sent WebSocket error frame
- * (`{error, error_code, retry_after}`).
+ * (`{error, error_code, code}`).
  */
 export function classifyWsFrame(data: {
   error?: string;
   error_code?: string;
+  code?: number;
   retry_after?: number;
 }): KugelAudioError {
   const errorCode = data.error_code;
   const message = data.error ?? 'Server reported an error.';
+  const status = typeof data.code === 'number' ? data.code : undefined;
   const retryAfter = typeof data.retry_after === 'number' ? data.retry_after : undefined;
-  return build(undefined, errorCode, message, { retryAfter });
+  return build(status, errorCode, message, { retryAfter });
 }
 
 /**