@speechall/sdk 0.0.1 → 2.0.4

package/src/errors/handleNonStatusCodeError.ts

@@ -0,0 +1,37 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../core/index.js";
+import * as errors from "./index.js";
+
+export function handleNonStatusCodeError(
+    error: core.Fetcher.Error,
+    rawResponse: core.RawResponse,
+    method: string,
+    path: string,
+): never {
+    switch (error.reason) {
+        case "non-json":
+            throw new errors.SpeechallError({
+                statusCode: error.statusCode,
+                body: error.rawBody,
+                rawResponse: rawResponse,
+            });
+        case "body-is-null":
+            throw new errors.SpeechallError({
+                statusCode: error.statusCode,
+                rawResponse: rawResponse,
+            });
+        case "timeout":
+            throw new errors.SpeechallTimeoutError(`Timeout exceeded when calling ${method} ${path}.`);
+        case "unknown":
+            throw new errors.SpeechallError({
+                message: error.errorMessage,
+                rawResponse: rawResponse,
+            });
+        default:
+            throw new errors.SpeechallError({
+                message: "Unknown error",
+                rawResponse: rawResponse,
+            });
+    }
+}

package/src/errors/index.ts

@@ -0,0 +1,2 @@
+export { SpeechallError } from "./SpeechallError.js";
+export { SpeechallTimeoutError } from "./SpeechallTimeoutError.js";

package/src/exports.ts

@@ -0,0 +1 @@
+export * from "./core/exports.js";

package/src/index.ts

@@ -0,0 +1,6 @@
+export * as Speechall from "./api/index.js";
+export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+export { SpeechallClient } from "./Client.js";
+export { SpeechallEnvironment } from "./environments.js";
+export { SpeechallError, SpeechallTimeoutError } from "./errors/index.js";
+export * from "./exports.js";

package/test-import.ts

@@ -0,0 +1,17 @@
+// Quick test to verify SDK imports work
+import { SpeechallClient } from './dist';
+
+console.log('SDK imported successfully');
+console.log('SpeechallClient:', typeof SpeechallClient);
+
+// Test basic client initialization
+try {
+  const client = new SpeechallClient({
+    token: 'test-api-token',
+  });
+  console.log('Client initialized successfully');
+  console.log('Client type:', client.constructor.name);
+  console.log('Available methods:', Object.keys(Object.getPrototypeOf(client)));
+} catch (error) {
+  console.error('Failed to initialize client:', error);
+}

package/tests/integration/api.test.ts

@@ -0,0 +1,93 @@
+import { SpeechallClient } from '../../src';
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Skip integration tests if no API token is provided
+const runIntegration = process.env.SPEECHALL_API_TOKEN !== undefined;
+const describeIntegration = runIntegration ? describe : describe.skip;
+
+describeIntegration('API Integration Tests', () => {
+  let client: SpeechallClient;
+
+  beforeAll(() => {
+    client = new SpeechallClient({
+      token: process.env.SPEECHALL_API_TOKEN!,
+    });
+  });
+
+  describe('SpeechToText API', () => {
+    it('should transcribe audio file', async () => {
+      // This test requires an actual audio file and API token
+      // Skip if no audio fixture is available
+      const audioPath = path.join(__dirname, '../fixtures/audio-sample.wav');
+
+      if (!fs.existsSync(audioPath)) {
+        console.log('Skipping: No audio fixture available');
+        return;
+      }
+
+      const audioBuffer = fs.readFileSync(audioPath);
+      const audioFile = new File([audioBuffer], 'audio-sample.wav', {
+        type: 'audio/wav',
+      });
+
+      const response = await client.speechToText.transcribe(
+        audioFile,
+        {
+          model: 'openai.whisper-1',
+        }
+      );
+
+      expect(response).toBeDefined();
+      // Add more specific assertions based on your API response structure
+    }, 30000); // 30 second timeout for API calls
+
+    it('should list available speech-to-text models', async () => {
+      const models = await client.speechToText.listSpeechToTextModels();
+
+      expect(models).toBeDefined();
+      expect(Array.isArray(models)).toBe(true);
+    }, 30000);
+  });
+
+  describe('Replacement Rules API', () => {
+    it('should create replacement ruleset', async () => {
+      const ruleset = await client.replacementRules.createReplacementRuleset({
+        name: 'Test Ruleset',
+        rules: [
+          {
+            kind: 'exact',
+            search: 'test',
+            replacement: 'TEST',
+          },
+        ],
+      });
+
+      expect(ruleset).toBeDefined();
+      expect(ruleset.id).toBeDefined();
+    });
+  });
+});
+
+// Mock integration tests that always run
+describe('API Integration Tests (Mocked)', () => {
+  let client: SpeechallClient;
+
+  beforeEach(() => {
+    client = new SpeechallClient({
+      token: 'mock-api-token',
+    });
+  });
+
+  it('should have speechToText client available', () => {
+    expect(client.speechToText).toBeDefined();
+    expect(typeof client.speechToText.transcribe).toBe('function');
+    expect(typeof client.speechToText.transcribeRemote).toBe('function');
+    expect(typeof client.speechToText.listSpeechToTextModels).toBe('function');
+  });
+
+  it('should have replacementRules client available', () => {
+    expect(client.replacementRules).toBeDefined();
+    expect(typeof client.replacementRules.createReplacementRuleset).toBe('function');
+  });
+});

package/tests/unit/client.test.ts

@@ -0,0 +1,91 @@
+import { SpeechallClient, SpeechallError } from '../../src';
+
+describe('SpeechallClient', () => {
+  describe('initialization', () => {
+    it('should initialize with token', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+      });
+      expect(client).toBeDefined();
+      expect(client).toBeInstanceOf(SpeechallClient);
+    });
+
+    it('should initialize with token as a function', () => {
+      const client = new SpeechallClient({
+        token: () => 'test-api-token',
+      });
+      expect(client).toBeDefined();
+      expect(client).toBeInstanceOf(SpeechallClient);
+    });
+
+    it('should expose speechToText client', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+      });
+      expect(client.speechToText).toBeDefined();
+    });
+
+    it('should expose replacementRules client', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+      });
+      expect(client.replacementRules).toBeDefined();
+    });
+  });
+
+  describe('configuration', () => {
+    it('should accept custom baseUrl', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+        baseUrl: 'https://custom-api.example.com',
+      });
+      expect(client).toBeDefined();
+    });
+
+    it('should accept custom headers', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+        headers: {
+          'X-Custom-Header': 'custom-value',
+        },
+      });
+      expect(client).toBeDefined();
+    });
+
+    it('should accept timeout configuration', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+        timeoutInSeconds: 30,
+      });
+      expect(client).toBeDefined();
+    });
+
+    it('should accept maxRetries configuration', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+        maxRetries: 5,
+      });
+      expect(client).toBeDefined();
+    });
+  });
+
+  describe('lazy initialization', () => {
+    it('should lazily initialize speechToText client', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+      });
+      const firstAccess = client.speechToText;
+      const secondAccess = client.speechToText;
+      expect(firstAccess).toBe(secondAccess);
+    });
+
+    it('should lazily initialize replacementRules client', () => {
+      const client = new SpeechallClient({
+        token: 'test-api-token',
+      });
+      const firstAccess = client.replacementRules;
+      const secondAccess = client.replacementRules;
+      expect(firstAccess).toBe(secondAccess);
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests", "examples"]
+}