async.ts — typescript-sdk Source File

Source Code

/**
 * Async Client Wrapper for Supermodel API
 * 
 * Provides automatic polling for async job endpoints, so you can use them
 * like synchronous APIs without manually implementing polling loops.
 * 
 * @example
 * ```typescript
 * import { DefaultApi, Configuration, SupermodelClient } from '@supermodeltools/sdk';
 * 
 * const api = new DefaultApi(new Configuration({ 
 *   basePath: 'https://api.supermodel.tools',
 *   apiKey: () => 'your-api-key'
 * }));
 * 
 * const client = new SupermodelClient(api);
 * 
 * // Returns the unwrapped result - polling is automatic!
 * const graph = await client.generateDependencyGraph(zipFile);
 * console.log(graph.graph.nodes.length);
 * ```
 */

import type { InitOverrideFunction } from './runtime';
import type { DefaultApi } from './apis/DefaultApi';
import type {
  CodeGraphEnvelope,
  CodeGraphEnvelopeAsync,
  DomainClassificationResponse,
  DomainClassificationResponseAsync,
  SupermodelIR,
  SupermodelIRAsync,
} from './models';

/**
 * Configuration options for the async client.
 */
export interface AsyncClientOptions {
  /**
   * Maximum time to wait for a job to complete (in milliseconds).
   * Default: 900000 (15 minutes)
   */
  timeoutMs?: number;

  /**
   * Default retry interval when server doesn't specify (in milliseconds).
   * Default: 10000 (10 seconds)
   */
  defaultRetryIntervalMs?: number;

  /**
   * Maximum number of polling attempts.
   * Default: 90
   */
  maxPollingAttempts?: number;

  /**
   * Callback for polling progress updates.
   * Useful for showing progress indicators in UIs.
   */
// ... (317 more lines)