@voice-kit/core 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,3 +1,262 @@
+// src/errors/base.ts
+var VoiceKitError = class extends Error {
+  code;
+  callId;
+  provider;
+  retryable;
+  severity;
+  cause;
+  constructor(params) {
+    super(params.message);
+    this.name = this.constructor.name;
+    this.code = params.code;
+    this.callId = params.callId;
+    this.provider = params.provider;
+    this.retryable = params.retryable ?? false;
+    this.severity = params.severity ?? "medium";
+    this.cause = params.cause;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      callId: this.callId,
+      provider: this.provider,
+      retryable: this.retryable,
+      severity: this.severity
+    };
+  }
+};
 
+// src/errors/agents.errors.ts
+var AgentError = class extends VoiceKitError {
+};
+var TurnTransitionError = class extends AgentError {
+  fromState;
+  event;
+  constructor(fromState, toEvent, callId) {
+    super({
+      code: "AGENT_INVALID_TURN_TRANSITION",
+      message: `Invalid turn transition: state '${fromState}' cannot handle event '${toEvent}'`,
+      callId,
+      retryable: false,
+      severity: "medium"
+    });
+    this.fromState = fromState;
+    this.event = toEvent;
+  }
+};
+var AgentHandoffError = class extends AgentError {
+  constructor(capability, cause, callId) {
+    super({
+      code: "AGENT_HANDOFF_FAILED",
+      message: `Handoff to '${capability}' agent failed`,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+
+// src/errors/compliance.ts
+var ComplianceError = class extends VoiceKitError {
+  phoneNumber;
+  constructor(params) {
+    super({ ...params, provider: "trai" });
+    this.phoneNumber = params.phoneNumber;
+  }
+};
+var DNCBlockedError = class extends ComplianceError {
+  constructor(phoneNumber, callId) {
+    super({
+      code: "COMPLIANCE_DNC_BLOCKED",
+      message: `Number ${phoneNumber} is on DNC registry \u2014 call blocked`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var CallingHoursError = class extends ComplianceError {
+  constructor(phoneNumber, currentTime, callId) {
+    super({
+      code: "COMPLIANCE_OUTSIDE_CALLING_HOURS",
+      message: `Call to ${phoneNumber} blocked \u2014 outside TRAI calling hours (current: ${currentTime} IST)`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var ConsentMissingError = class extends ComplianceError {
+  constructor(phoneNumber, callId) {
+    super({
+      code: "COMPLIANCE_CONSENT_MISSING",
+      message: `No valid consent on record for ${phoneNumber}`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "medium"
+    });
+  }
+};
+
+// src/errors/inngest.errors.ts
+var InngestError = class extends VoiceKitError {
+  taskName;
+  constructor(params) {
+    super({
+      ...params,
+      provider: "inngest",
+      retryable: true,
+      severity: "medium"
+    });
+    this.taskName = params.taskName;
+  }
+};
+
+// src/errors/stt.errors.ts
+var STTError = class extends VoiceKitError {
+  languageCode;
+  constructor(params) {
+    super(params);
+    this.languageCode = params.languageCode;
+  }
+};
+var STTConnectionError = class extends STTError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "STT_CONNECTION_FAILED",
+      message: `Failed to connect to ${provider} STT service`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var STTStreamError = class extends STTError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "STT_STREAM_ERROR",
+      message: `STT stream error from ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "medium",
+      cause
+    });
+  }
+};
+var STTLanguageNotSupportedError = class extends STTError {
+  constructor(provider, language) {
+    super({
+      code: "STT_LANGUAGE_NOT_SUPPORTED",
+      message: `Language '${language}' is not supported by ${provider}`,
+      provider,
+      retryable: false,
+      severity: "low",
+      languageCode: language
+    });
+  }
+};
+
+// src/errors/telephony.errors.ts
+var TelephonyError = class extends VoiceKitError {
+  to;
+  from;
+  constructor(params) {
+    super(params);
+    this.to = params.to;
+    this.from = params.from;
+  }
+};
+var CallConnectionError = class extends TelephonyError {
+  constructor(provider, to, cause) {
+    super({
+      code: "CALL_CONNECTION_FAILED",
+      message: `Failed to connect call to ${to} via ${provider}`,
+      provider,
+      to,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var CallNotFoundError = class extends TelephonyError {
+  constructor(callId, provider) {
+    super({
+      code: "CALL_NOT_FOUND",
+      message: `Call '${callId}' not found on ${provider}`,
+      callId,
+      provider,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var AudioTransportError = class extends TelephonyError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "AUDIO_TRANSPORT_ERROR",
+      message: `Audio transport error on ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+
+// src/errors/tts.errors.ts
+var TTSError = class extends VoiceKitError {
+};
+var TTSConnectionError = class extends TTSError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "TTS_CONNECTION_FAILED",
+      message: `Failed to connect to ${provider} TTS service`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var TTSStreamError = class extends TTSError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "TTS_STREAM_ERROR",
+      message: `TTS stream error from ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "medium",
+      cause
+    });
+  }
+};
+var TTSVoiceNotFoundError = class extends TTSError {
+  constructor(provider, voiceId) {
+    super({
+      code: "TTS_VOICE_NOT_FOUND",
+      message: `Voice '${voiceId}' not found on ${provider}`,
+      provider,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+
+export { AgentError, AgentHandoffError, AudioTransportError, CallConnectionError, CallNotFoundError, CallingHoursError, ComplianceError, ConsentMissingError, DNCBlockedError, InngestError, STTConnectionError, STTError, STTLanguageNotSupportedError, STTStreamError, TTSConnectionError, TTSError, TTSStreamError, TTSVoiceNotFoundError, TelephonyError, TurnTransitionError, VoiceKitError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../src/errors/base.ts","../src/errors/agents.errors.ts","../src/errors/compliance.ts","../src/errors/inngest.errors.ts","../src/errors/stt.errors.ts","../src/errors/telephony.errors.ts","../src/errors/tts.errors.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @voice-kit/core — Typed error hierarchy\r\n *\r\n * All VoiceKit errors extend VoiceKitError. Never throw raw Error.\r\n * Every error carries: code, message, provider, callId, retryable, severity.\r\n */\r\n\r\nimport type { ErrorSeverity } from '../types'\r\n\r\n// ─── Base Error ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Base class for all VoiceKit errors. Provides structured context for\r\n * logging, alerting, and programmatic error handling.\r\n *\r\n * @example\r\n * ```ts\r\n * try {\r\n *   await stt.transcribeBatch(audio)\r\n * } catch (err) {\r\n *   if (err instanceof STTError) {\r\n *     console.error(err.code, err.provider, err.retryable)\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class VoiceKitError extends Error {\r\n    readonly code: string\r\n    readonly callId?: string\r\n    readonly provider?: string\r\n    readonly retryable: boolean\r\n    readonly severity: ErrorSeverity\r\n    override readonly cause?: unknown\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n    }) {\r\n        super(params.message)\r\n        this.name = this.constructor.name\r\n        this.code = params.code\r\n        this.callId = params.callId\r\n        this.provider = params.provider\r\n        this.retryable = params.retryable ?? false\r\n        this.severity = params.severity ?? 'medium'\r\n        this.cause = params.cause\r\n\r\n        // Maintains proper prototype chain for `instanceof` in transpiled code\r\n        Object.setPrototypeOf(this, new.target.prototype)\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            callId: this.callId,\r\n            provider: this.provider,\r\n            retryable: this.retryable,\r\n            severity: this.severity,\r\n        }\r\n    }\r\n}","\r\n// ─── Agent Errors ─────────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from agent orchestration (turn engine, handoff, injection).\r\n */\r\nexport class AgentError extends VoiceKitError { }\r\n\r\nexport class TurnTransitionError extends AgentError {\r\n    readonly fromState: string\r\n    readonly event: string\r\n\r\n    constructor(fromState: string, toEvent: string, callId?: string) {\r\n        super({\r\n            code: 'AGENT_INVALID_TURN_TRANSITION',\r\n            message: `Invalid turn transition: state '${fromState}' cannot handle event '${toEvent}'`,\r\n            callId,\r\n            retryable: false,\r\n            severity: 'medium',\r\n        })\r\n        this.fromState = fromState\r\n        this.event = toEvent\r\n    }\r\n}\r\n\r\nexport class AgentHandoffError extends AgentError {\r\n    constructor(capability: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'AGENT_HANDOFF_FAILED',\r\n            message: `Handoff to '${capability}' agent failed`,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── Compliance Errors ────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from compliance checks (TRAI DNC, calling hours, consent).\r\n */\r\nexport class ComplianceError extends VoiceKitError {\r\n    readonly phoneNumber?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        phoneNumber?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n    }) {\r\n        super({ ...params, provider: 'trai' })\r\n        this.phoneNumber = params.phoneNumber\r\n    }\r\n}\r\n\r\nexport class DNCBlockedError extends ComplianceError {\r\n    constructor(phoneNumber: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_DNC_BLOCKED',\r\n            message: `Number ${phoneNumber} is on DNC registry — call blocked`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class CallingHoursError extends ComplianceError {\r\n    constructor(phoneNumber: string, currentTime: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_OUTSIDE_CALLING_HOURS',\r\n            message: `Call to ${phoneNumber} blocked — outside TRAI calling hours (current: ${currentTime} IST)`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class ConsentMissingError extends ComplianceError {\r\n    constructor(phoneNumber: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_CONSENT_MISSING',\r\n            message: `No valid consent on record for ${phoneNumber}`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'medium',\r\n        })\r\n    }\r\n}\r\n","\r\n\r\n// ─── Inngest Errors ───────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from Inngest background task dispatch.\r\n */\r\nexport class InngestError extends VoiceKitError {\r\n    readonly taskName?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        taskName?: string\r\n        cause?: unknown\r\n    }) {\r\n        super({\r\n            ...params,\r\n            provider: 'inngest',\r\n            retryable: true,\r\n            severity: 'medium',\r\n        })\r\n        this.taskName = params.taskName\r\n    }\r\n}","\r\n// ─── STT Errors ───────────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from speech-to-text providers.\r\n */\r\nexport class STTError extends VoiceKitError {\r\n    readonly languageCode?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n        languageCode?: string\r\n    }) {\r\n        super(params)\r\n        this.languageCode = params.languageCode\r\n    }\r\n}\r\n\r\nexport class STTConnectionError extends STTError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'STT_CONNECTION_FAILED',\r\n            message: `Failed to connect to ${provider} STT service`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class STTStreamError extends STTError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'STT_STREAM_ERROR',\r\n            message: `STT stream error from ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'medium',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class STTLanguageNotSupportedError extends STTError {\r\n    constructor(provider: string, language: string) {\r\n        super({\r\n            code: 'STT_LANGUAGE_NOT_SUPPORTED',\r\n            message: `Language '${language}' is not supported by ${provider}`,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n            languageCode: language,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── Telephony Errors ─────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from telephony providers.\r\n */\r\nexport class TelephonyError extends VoiceKitError {\r\n    readonly to?: string\r\n    readonly from?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n        to?: string\r\n        from?: string\r\n    }) {\r\n        super(params)\r\n        this.to = params.to\r\n        this.from = params.from\r\n    }\r\n}\r\n\r\nexport class CallConnectionError extends TelephonyError {\r\n    constructor(provider: string, to: string, cause?: unknown) {\r\n        super({\r\n            code: 'CALL_CONNECTION_FAILED',\r\n            message: `Failed to connect call to ${to} via ${provider}`,\r\n            provider,\r\n            to,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class CallNotFoundError extends TelephonyError {\r\n    constructor(callId: string, provider: string) {\r\n        super({\r\n            code: 'CALL_NOT_FOUND',\r\n            message: `Call '${callId}' not found on ${provider}`,\r\n            callId,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class AudioTransportError extends TelephonyError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'AUDIO_TRANSPORT_ERROR',\r\n            message: `Audio transport error on ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── TTS Errors ───────────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from text-to-speech providers.\r\n */\r\nexport class TTSError extends VoiceKitError { }\r\n\r\nexport class TTSConnectionError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_CONNECTION_FAILED',\r\n            message: `Failed to connect to ${provider} TTS service`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSStreamError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_STREAM_ERROR',\r\n            message: `TTS stream error from ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'medium',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSVoiceNotFoundError extends TTSError {\r\n    constructor(provider: string, voiceId: string) {\r\n        super({\r\n            code: 'TTS_VOICE_NOT_FOUND',\r\n            message: `Voice '${voiceId}' not found on ${provider}`,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n"]}

package/dist/memory.d.cts

@@ -1,4 +1,4 @@
-import { CallMemoryConfig, CallMemory } from './index.cjs';
+import { C as CallMemoryConfig, a as CallMemory } from './index-D3KfRXMP.cjs';
 import 'ai';
 
 /**

package/dist/memory.d.ts

@@ -1,4 +1,4 @@
-import { CallMemoryConfig, CallMemory } from './index.js';
+import { C as CallMemoryConfig, a as CallMemory } from './index-D3KfRXMP.js';
 import 'ai';
 
 /**

package/dist/observability.d.cts

@@ -1,4 +1,4 @@
-import { CallMetricsSummary } from './index.cjs';
+import { d as CallMetricsSummary } from './index-D3KfRXMP.cjs';
 import 'ai';
 
 /**

package/dist/observability.d.ts

@@ -1,4 +1,4 @@
-import { CallMetricsSummary } from './index.js';
+import { d as CallMetricsSummary } from './index-D3KfRXMP.js';
 import 'ai';
 
 /**

package/dist/stt.d.cts

@@ -1,4 +1,4 @@
-import { STTProvider, STTConfig, STTResult } from './index.cjs';
+import { S as STTProvider, h as STTConfig, i as STTResult } from './index-D3KfRXMP.cjs';
 import { EventEmitter } from 'node:events';
 import 'ai';
 

package/dist/stt.d.ts

@@ -1,4 +1,4 @@
-import { STTProvider, STTConfig, STTResult } from './index.js';
+import { S as STTProvider, h as STTConfig, i as STTResult } from './index-D3KfRXMP.js';
 import { EventEmitter } from 'node:events';
 import 'ai';
 

package/dist/telephony.errors-BQYr6-vl.d.cts

@@ -0,0 +1,80 @@
+import { E as ErrorSeverity } from './index-D3KfRXMP.cjs';
+
+/**
+ * @voice-kit/core — Typed error hierarchy
+ *
+ * All VoiceKit errors extend VoiceKitError. Never throw raw Error.
+ * Every error carries: code, message, provider, callId, retryable, severity.
+ */
+
+/**
+ * Base class for all VoiceKit errors. Provides structured context for
+ * logging, alerting, and programmatic error handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await stt.transcribeBatch(audio)
+ * } catch (err) {
+ *   if (err instanceof STTError) {
+ *     console.error(err.code, err.provider, err.retryable)
+ *   }
+ * }
+ * ```
+ */
+declare class VoiceKitError extends Error {
+    readonly code: string;
+    readonly callId?: string;
+    readonly provider?: string;
+    readonly retryable: boolean;
+    readonly severity: ErrorSeverity;
+    readonly cause?: unknown;
+    constructor(params: {
+        code: string;
+        message: string;
+        callId?: string;
+        provider?: string;
+        retryable?: boolean;
+        severity?: ErrorSeverity;
+        cause?: unknown;
+    });
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        callId: string | undefined;
+        provider: string | undefined;
+        retryable: boolean;
+        severity: ErrorSeverity;
+    };
+}
+
+/**
+ * Errors from telephony providers.
+ */
+declare class TelephonyError extends VoiceKitError {
+    readonly to?: string;
+    readonly from?: string;
+    constructor(params: {
+        code: string;
+        message: string;
+        callId?: string;
+        provider?: string;
+        retryable?: boolean;
+        severity?: ErrorSeverity;
+        cause?: unknown;
+        to?: string;
+        from?: string;
+    });
+}
+declare class CallConnectionError extends TelephonyError {
+    constructor(provider: string, to: string, cause?: unknown);
+}
+declare class CallNotFoundError extends TelephonyError {
+    constructor(callId: string, provider: string);
+}
+declare class AudioTransportError extends TelephonyError {
+    constructor(provider: string, cause?: unknown, callId?: string);
+}
+
+export { AudioTransportError as A, CallConnectionError as C, TelephonyError as T, VoiceKitError as V, CallNotFoundError as a };

package/dist/telephony.errors-C0-nScrF.d.ts

@@ -0,0 +1,80 @@
+import { E as ErrorSeverity } from './index-D3KfRXMP.js';
+
+/**
+ * @voice-kit/core — Typed error hierarchy
+ *
+ * All VoiceKit errors extend VoiceKitError. Never throw raw Error.
+ * Every error carries: code, message, provider, callId, retryable, severity.
+ */
+
+/**
+ * Base class for all VoiceKit errors. Provides structured context for
+ * logging, alerting, and programmatic error handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await stt.transcribeBatch(audio)
+ * } catch (err) {
+ *   if (err instanceof STTError) {
+ *     console.error(err.code, err.provider, err.retryable)
+ *   }
+ * }
+ * ```
+ */
+declare class VoiceKitError extends Error {
+    readonly code: string;
+    readonly callId?: string;
+    readonly provider?: string;
+    readonly retryable: boolean;
+    readonly severity: ErrorSeverity;
+    readonly cause?: unknown;
+    constructor(params: {
+        code: string;
+        message: string;
+        callId?: string;
+        provider?: string;
+        retryable?: boolean;
+        severity?: ErrorSeverity;
+        cause?: unknown;
+    });
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        callId: string | undefined;
+        provider: string | undefined;
+        retryable: boolean;
+        severity: ErrorSeverity;
+    };
+}
+
+/**
+ * Errors from telephony providers.
+ */
+declare class TelephonyError extends VoiceKitError {
+    readonly to?: string;
+    readonly from?: string;
+    constructor(params: {
+        code: string;
+        message: string;
+        callId?: string;
+        provider?: string;
+        retryable?: boolean;
+        severity?: ErrorSeverity;
+        cause?: unknown;
+        to?: string;
+        from?: string;
+    });
+}
+declare class CallConnectionError extends TelephonyError {
+    constructor(provider: string, to: string, cause?: unknown);
+}
+declare class CallNotFoundError extends TelephonyError {
+    constructor(callId: string, provider: string);
+}
+declare class AudioTransportError extends TelephonyError {
+    constructor(provider: string, cause?: unknown, callId?: string);
+}
+
+export { AudioTransportError as A, CallConnectionError as C, TelephonyError as T, VoiceKitError as V, CallNotFoundError as a };

package/dist/tts.d.cts

@@ -1,4 +1,4 @@
-import { TTSProvider, TTSConfig } from './index.cjs';
+import { e as TTSProvider, f as TTSConfig } from './index-D3KfRXMP.cjs';
 import 'ai';
 
 /**

package/dist/tts.d.ts

@@ -1,4 +1,4 @@
-import { TTSProvider, TTSConfig } from './index.js';
+import { e as TTSProvider, f as TTSConfig } from './index-D3KfRXMP.js';
 import 'ai';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voice-kit/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Core STT, TTS, audio, codecs, VAD, transports for @voice-kit",
   "type": "module",
   "author": {
@@ -8,12 +8,20 @@
   },
   "packageManager": "bun@1.3.10",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./audio": {
+      "types": "./dist/audio/index.d.ts",
+      "import": "./dist/audio/index.js",
+      "require": "./dist/audio/index.cjs"
+    },
     "./compliance": {
       "types": "./dist/compliance/index.d.ts",
       "import": "./dist/compliance/index.js",