truss-api-mcp 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+export type LicenseTier = 'free' | 'pro';
+export interface LicenseStatus {
+    tier: LicenseTier;
+    valid: boolean;
+    expiresAt: string | null;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface HttpRequest {
+    method: HttpMethod;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+}
+export interface HttpResponse {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: unknown;
+    timing_ms: number;
+    size_bytes: number;
+}
+export interface OpenApiInfo {
+    title: string;
+    version: string;
+    description?: string;
+}
+export interface OpenApiParameter {
+    name: string;
+    in: 'query' | 'path' | 'header' | 'cookie';
+    required: boolean;
+    description?: string;
+    schema?: JsonSchema;
+}
+export interface OpenApiResponse {
+    status: string;
+    description: string;
+    schema?: JsonSchema;
+}
+export interface OpenApiEndpoint {
+    method: string;
+    path: string;
+    summary: string;
+    operationId?: string;
+    parameters: OpenApiParameter[];
+    requestBody?: JsonSchema;
+    responses: OpenApiResponse[];
+    tags?: string[];
+}
+export interface ParsedOpenApiSpec {
+    info: OpenApiInfo;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    endpoints: OpenApiEndpoint[];
+}
+export interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    enum?: unknown[];
+    format?: string;
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    additionalProperties?: boolean | JsonSchema;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    nullable?: boolean;
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    expected?: string;
+    actual?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+export type CodeLanguage = 'typescript' | 'python' | 'go';
+export type HttpStyle = 'fetch' | 'axios';
+export type TestFramework = 'jest' | 'vitest' | 'pytest';
+export interface SpecChange {
+    path: string;
+    method?: string;
+    description: string;
+}
+export interface SpecComparison {
+    breaking_changes: SpecChange[];
+    non_breaking: SpecChange[];
+    new_endpoints: SpecChange[];
+    removed_endpoints: SpecChange[];
+}
+export interface MockRoute {
+    method: string;
+    path: string;
+    status: number;
+    response: unknown;
+    headers?: Record<string, string>;
+}
+export interface MockServerConfig {
+    routes: MockRoute[];
+    mock_data: Record<string, unknown>;
+}
+export interface RequestExample {
+    method: string;
+    url: string;
+    request_body?: unknown;
+    response_body: unknown;
+    status: number;
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── License Types ────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

package/evals/eval-http.ts

@@ -0,0 +1,163 @@
+/**
+ * Evaluation: HTTP client and response validation
+ */
+
+import { executeRequest } from '../src/lib/http-client.js';
+import { validateResponse, validateSchema } from '../src/lib/schema-validator.js';
+
+interface EvalResult {
+  name: string;
+  passed: boolean;
+  error?: string;
+  duration_ms?: number;
+}
+
+const results: EvalResult[] = [];
+
+async function run(name: string, fn: () => Promise<void>): Promise<void> {
+  const start = performance.now();
+  try {
+    await fn();
+    results.push({ name, passed: true, duration_ms: Math.round(performance.now() - start) });
+  } catch (err) {
+    results.push({
+      name,
+      passed: false,
+      error: err instanceof Error ? err.message : String(err),
+      duration_ms: Math.round(performance.now() - start),
+    });
+  }
+}
+
+function assert(condition: boolean, message: string): void {
+  if (!condition) throw new Error(message);
+}
+
+// ── Tests ───────────────────────────────────────────────────────────
+
+await run('GET request to httpbin', async () => {
+  const resp = await executeRequest({
+    method: 'GET',
+    url: 'https://httpbin.org/get',
+    headers: { 'X-Test': 'eval' },
+  });
+
+  assert(resp.status === 200, `Expected 200, got ${resp.status}`);
+  assert(resp.timing_ms > 0, 'Timing should be positive');
+  assert(resp.size_bytes > 0, 'Size should be positive');
+  assert(typeof resp.body === 'object', 'Body should be an object');
+});
+
+await run('POST request with JSON body', async () => {
+  const resp = await executeRequest({
+    method: 'POST',
+    url: 'https://httpbin.org/post',
+    body: { key: 'value', number: 42 },
+  });
+
+  assert(resp.status === 200, `Expected 200, got ${resp.status}`);
+  const body = resp.body as Record<string, unknown>;
+  assert(typeof body.json === 'object', 'Body should contain parsed JSON');
+});
+
+await run('Validate response — matching schema', async () => {
+  const result = validateResponse(
+    { status: 200, body: { name: 'Test', age: 25, active: true } },
+    200,
+    {
+      type: 'object',
+      required: ['name', 'age'],
+      properties: {
+        name: { type: 'string' },
+        age: { type: 'integer', minimum: 0 },
+        active: { type: 'boolean' },
+      },
+    }
+  );
+
+  assert(result.valid === true, `Expected valid, got errors: ${JSON.stringify(result.errors)}`);
+});
+
+await run('Validate response — wrong status', async () => {
+  const result = validateResponse(
+    { status: 404, body: { error: 'not found' } },
+    200
+  );
+
+  assert(result.valid === false, 'Expected validation failure');
+  assert(result.errors.length > 0, 'Expected at least one error');
+  assert(result.errors[0].path === '$.status', 'Error should be on status');
+});
+
+await run('Validate response — schema mismatch', async () => {
+  const result = validateResponse(
+    { status: 200, body: { name: 123 } },
+    200,
+    {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+      },
+    }
+  );
+
+  assert(result.valid === false, 'Expected validation failure');
+  assert(result.errors.some((e) => e.path.includes('name')), 'Error should mention name');
+});
+
+await run('Schema validation — required fields', async () => {
+  const result = validateSchema(
+    { a: 1 },
+    { type: 'object', required: ['a', 'b'], properties: { a: { type: 'integer' }, b: { type: 'string' } } }
+  );
+
+  assert(result.valid === false, 'Expected failure — missing required field b');
+  assert(result.errors.some((e) => e.message.includes('b')), 'Error should mention field b');
+});
+
+await run('Schema validation — enum', async () => {
+  const result = validateSchema('red', { enum: ['red', 'green', 'blue'] });
+  assert(result.valid === true, 'red should be valid enum value');
+
+  const result2 = validateSchema('purple', { enum: ['red', 'green', 'blue'] });
+  assert(result2.valid === false, 'purple should not be valid enum value');
+});
+
+await run('Schema validation — array items', async () => {
+  const result = validateSchema(
+    [1, 2, 'three'],
+    { type: 'array', items: { type: 'integer' } }
+  );
+
+  assert(result.valid === false, 'Array with string item should fail integer validation');
+});
+
+await run('Schema validation — string constraints', async () => {
+  const result = validateSchema('ab', { type: 'string', minLength: 3 });
+  assert(result.valid === false, 'String too short');
+
+  const result2 = validateSchema('abc', { type: 'string', minLength: 3, maxLength: 5 });
+  assert(result2.valid === true, 'String within range');
+});
+
+await run('Schema validation — number constraints', async () => {
+  const result = validateSchema(5, { type: 'number', minimum: 10 });
+  assert(result.valid === false, '5 < minimum 10');
+
+  const result2 = validateSchema(15, { type: 'number', minimum: 10, maximum: 20 });
+  assert(result2.valid === true, '15 within [10, 20]');
+});
+
+// ── Report ──────────────────────────────────────────────────────────
+
+export { results };
+
+const passed = results.filter((r) => r.passed).length;
+const failed = results.filter((r) => !r.passed).length;
+
+console.log(`\nHTTP & Validation Evals: ${passed} passed, ${failed} failed\n`);
+for (const r of results) {
+  const icon = r.passed ? 'PASS' : 'FAIL';
+  console.log(`  [${icon}] ${r.name}${r.duration_ms ? ` (${r.duration_ms}ms)` : ''}`);
+  if (r.error) console.log(`         ${r.error}`);
+}