@dataferry/sdk 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/resources/portalSessions.ts","../src/resources/exports.ts","../src/resources/connections.ts","../src/client.ts"],"sourcesContent":["// Primary exports\nexport {\n  Ferry,\n  FerryError,\n  type FerryConfig,\n  type CreatePortalSessionParams,\n  type PortalSessionResult,\n} from './client.js';\n\n// Resource classes for advanced usage\nexport { PortalSessions } from './resources/portalSessions.js';\nexport { Exports } from './resources/exports.js';\nexport { Connections } from './resources/connections.js';\n\n// Re-export common types\nexport type {\n  ExportJob,\n  ExportStatus,\n  ExportFormat,\n  CreateExportRequest,\n  CreatePortalSessionRequest,\n  CreatePortalSessionResponse,\n  SchemaConfig,\n  WebhookEndpoint,\n  WebhookEvent,\n  DatabaseConnection,\n  CreateConnectionRequest,\n  UpdateConnectionRequest,\n  TestConnectionResult,\n} from './types.js';\n","/**\n * Portal Sessions resource\n */\n\nimport type { Ferry } from '../client.js';\nimport type {\n  CreatePortalSessionRequest,\n  CreatePortalSessionResponse,\n  PortalSession,\n} from '../types.js';\n\nexport class PortalSessions {\n  constructor(private readonly client: Ferry) {}\n\n  /**\n   * Create a new portal session for an end user\n   *\n   * @example\n   * ```ts\n   * const session = await ferry.portalSessions.create({\n   *   profile: 'default',\n   *   scopeId: 'user_123',\n   *   expiresIn: 3600,\n   *   returnUrl: 'https://yourapp.com/settings',\n   * });\n   *\n   * // Redirect user to session.url\n   * ```\n   */\n  async create(\n    params: CreatePortalSessionRequest\n  ): Promise<CreatePortalSessionResponse> {\n    return this.client.request<CreatePortalSessionResponse>(\n      'POST',\n      '/api/v1/portal-sessions',\n      params\n    );\n  }\n\n  /**\n   * Get portal session details\n   *\n   * @example\n   * ```ts\n   * const session = await ferry.portalSessions.retrieve('ps_abc123');\n   * console.log(session.scopeId, session.expiresAt);\n   * ```\n   */\n  async retrieve(\n    sessionId: string\n  ): Promise<PortalSession & { isExpired: boolean }> {\n    return this.client.request<PortalSession & { isExpired: boolean }>(\n      'GET',\n      `/api/v1/portal-sessions/${sessionId}`\n    );\n  }\n\n  /**\n   * Revoke a portal session\n   *\n   * @example\n   * ```ts\n   * await ferry.portalSessions.revoke('ps_abc123');\n   * ```\n   */\n  async revoke(sessionId: string): Promise<{ id: string }> {\n    return this.client.request<{ id: string }>(\n      'DELETE',\n      `/api/v1/portal-sessions/${sessionId}`\n    );\n  }\n}\n","/**\n * Exports resource\n */\n\nimport type { Ferry } from '../client.js';\nimport type {\n  CreateExportRequest,\n  ExportStatus,\n} from '../types.js';\n\ninterface ExportResponse {\n  id: string;\n  status: ExportStatus;\n  scopeId: string;\n  /** Database connection ID used for this export */\n  connectionId?: string;\n  /** Database connection name (if connection still exists) */\n  connectionName?: string;\n  format: string;\n  tables: string[];\n  downloadUrl?: string;\n  downloadUrlExpiresAt?: string;\n  fileSizeBytes?: number;\n  totalRows?: number;\n  errorMessage?: string;\n  errorCode?: string;\n  createdAt: string;\n  startedAt?: string;\n  completedAt?: string;\n}\n\ninterface ListExportsParams extends Record<string, string | number | undefined> {\n  scopeId?: string;\n  /** Filter by database connection ID */\n  connectionId?: string;\n  status?: ExportStatus;\n  page?: number;\n  limit?: number;\n}\n\nexport class Exports {\n  constructor(private readonly client: Ferry) {}\n\n  /**\n   * Create a new export job\n   *\n   * @example\n   * ```ts\n   * // Create export using primary connection\n   * const exportJob = await ferry.exports.create({\n   *   scopeId: 'user_123',\n   *   format: 'csv',\n   *   tables: ['users', 'posts', 'comments'],\n   * });\n   *\n   * // Create export using specific connection\n   * const exportJob = await ferry.exports.create({\n   *   scopeId: 'user_123',\n   *   connectionId: 'conn_abc123',\n   *   format: 'csv',\n   *   tables: ['users', 'posts'],\n   * });\n   *\n   * console.log(exportJob.id, exportJob.status);\n   * ```\n   */\n  async create(params: CreateExportRequest): Promise<ExportResponse> {\n    return this.client.request<ExportResponse>(\n      'POST',\n      '/api/v1/exports',\n      params\n    );\n  }\n\n  /**\n   * Get export job details\n   *\n   * @example\n   * ```ts\n   * const exportJob = await ferry.exports.retrieve('exp_abc123');\n   *\n   * if (exportJob.status === 'completed') {\n   *   console.log('Download:', exportJob.downloadUrl);\n   * }\n   * ```\n   */\n  async retrieve(exportId: string): Promise<ExportResponse> {\n    return this.client.request<ExportResponse>(\n      'GET',\n      `/api/v1/exports/${exportId}`\n    );\n  }\n\n  /**\n   * List exports\n   *\n   * @example\n   * ```ts\n   * // List all exports\n   * const { data, meta } = await ferry.exports.list();\n   *\n   * // Filter by scope\n   * const { data } = await ferry.exports.list({ scopeId: 'user_123' });\n   *\n   * // Filter by status\n   * const { data } = await ferry.exports.list({ status: 'completed' });\n   *\n   * // Filter by connection\n   * const { data } = await ferry.exports.list({ connectionId: 'conn_abc123' });\n   * ```\n   */\n  async list(params?: ListExportsParams): Promise<{\n    data: ExportResponse[];\n    meta: { page: number; limit: number; total: number; totalPages: number } | undefined;\n  }> {\n    return this.client.requestPaginated<ExportResponse>(\n      '/api/v1/exports',\n      params\n    );\n  }\n\n  /**\n   * Wait for an export to complete\n   *\n   * @example\n   * ```ts\n   * const exportJob = await ferry.exports.create({ scopeId: 'user_123' });\n   * const completed = await ferry.exports.poll(exportJob.id, { maxWait: 300000 });\n   *\n   * if (completed.status === 'completed') {\n   *   console.log('Download:', completed.downloadUrl);\n   * }\n   * ```\n   */\n  async poll(\n    exportId: string,\n    options: { maxWait?: number; interval?: number } = {}\n  ): Promise<ExportResponse> {\n    const maxWait = options.maxWait ?? 300000; // 5 minutes\n    const interval = options.interval ?? 2000; // 2 seconds\n    const startTime = Date.now();\n\n    while (Date.now() - startTime < maxWait) {\n      const exportJob = await this.retrieve(exportId);\n\n      if (\n        exportJob.status === 'completed' ||\n        exportJob.status === 'failed' ||\n        exportJob.status === 'expired'\n      ) {\n        return exportJob;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n\n    throw new Error(`Export ${exportId} did not complete within ${maxWait}ms`);\n  }\n}\n","/**\n * Database Connections resource\n */\n\nimport type { Ferry } from '../client.js';\nimport type {\n  DatabaseConnection,\n  CreateConnectionRequest,\n  UpdateConnectionRequest,\n  TestConnectionResult,\n} from '../types.js';\n\nexport class Connections {\n  constructor(private readonly client: Ferry) {}\n\n  /**\n   * List all database connections for the organization\n   *\n   * @example\n   * ```ts\n   * const connections = await ferry.connections.list();\n   * for (const conn of connections) {\n   *   console.log(conn.name);\n   * }\n   * ```\n   */\n  async list(): Promise<DatabaseConnection[]> {\n    const result = await this.client.requestPaginated<DatabaseConnection>(\n      '/api/v1/connections'\n    );\n    return result.data;\n  }\n\n  /**\n   * Create a new database connection\n   *\n   * @example\n   * ```ts\n   * const connection = await ferry.connections.create({\n   *   name: 'Production DB',\n   *   host: 'db.example.com',\n   *   port: '5432',\n   *   database: 'myapp',\n   *   user: 'ferry_readonly',\n   *   password: 'secret',\n   *   ssl: true,\n   * });\n   * ```\n   */\n  async create(params: CreateConnectionRequest): Promise<DatabaseConnection> {\n    return this.client.request<DatabaseConnection>(\n      'POST',\n      '/api/v1/connections',\n      params\n    );\n  }\n\n  /**\n   * Get a database connection by ID\n   *\n   * @example\n   * ```ts\n   * const connection = await ferry.connections.retrieve('conn_abc123');\n   * console.log(connection.host, connection.database);\n   * ```\n   */\n  async retrieve(connectionId: string): Promise<DatabaseConnection> {\n    return this.client.request<DatabaseConnection>(\n      'GET',\n      `/api/v1/connections/${connectionId}`\n    );\n  }\n\n  /**\n   * Update a database connection\n   *\n   * @example\n   * ```ts\n   * const connection = await ferry.connections.update('conn_abc123', {\n   *   name: 'Production DB (Updated)',\n   * });\n   * ```\n   */\n  async update(\n    connectionId: string,\n    params: UpdateConnectionRequest\n  ): Promise<DatabaseConnection> {\n    return this.client.request<DatabaseConnection>(\n      'PUT',\n      `/api/v1/connections/${connectionId}`,\n      params\n    );\n  }\n\n  /**\n   * Delete a database connection\n   *\n   * @example\n   * ```ts\n   * const result = await ferry.connections.delete('conn_abc123');\n   * console.log(result.deleted); // true\n   * ```\n   */\n  async delete(connectionId: string): Promise<{ id: string; deleted: boolean }> {\n    return this.client.request<{ id: string; deleted: boolean }>(\n      'DELETE',\n      `/api/v1/connections/${connectionId}`\n    );\n  }\n\n  /**\n   * Test a database connection\n   *\n   * @example\n   * ```ts\n   * const result = await ferry.connections.test('conn_abc123');\n   * if (result.connected) {\n   *   console.log(`Connected to ${result.database} as ${result.user}`);\n   * } else {\n   *   console.error(`Connection failed: ${result.error}`);\n   * }\n   * ```\n   */\n  async test(connectionId: string): Promise<TestConnectionResult> {\n    return this.client.request<TestConnectionResult>(\n      'POST',\n      `/api/v1/connections/${connectionId}/test`\n    );\n  }\n\n}\n","/**\n * DataFerry SDK client\n */\n\nimport { PortalSessions } from './resources/portalSessions.js';\nimport { Exports } from './resources/exports.js';\nimport { Connections } from './resources/connections.js';\n\nexport interface FerryConfig {\n  /** API key for authentication */\n  apiKey: string;\n  /** Base URL for the DataFerry API (default: https://api.dataferry.dev) */\n  baseUrl?: string;\n  /** Request timeout in milliseconds (default: 30000) */\n  timeout?: number;\n}\n\ninterface ApiResponse<T> {\n  success: boolean;\n  data?: T;\n  error?: {\n    code: string;\n    message: string;\n    details?: Record<string, unknown>;\n  };\n  meta?: {\n    page: number;\n    limit: number;\n    total: number;\n    totalPages: number;\n  };\n}\n\n/**\n * Parameters for creating a portal session\n */\nexport interface CreatePortalSessionParams {\n  /** Export profile name (required) */\n  profile: string;\n  /** The scope ID for data filtering (optional for single-tenant mode) */\n  scopeId?: string;\n  /** Return URL after export completes */\n  returnUrl?: string;\n  /** Custom session duration in seconds (default: 3600) */\n  expiresIn?: number;\n  /** End-user email for export completion notifications */\n  email?: string;\n  /** Custom metadata to attach to the session */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Portal session response\n */\nexport interface PortalSessionResult {\n  /** Session ID */\n  id: string;\n  /** URL to redirect the user to */\n  url: string;\n  /** When the session expires */\n  expiresAt: Date;\n}\n\nexport class Ferry {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  /** Portal session management */\n  public readonly portalSessions: PortalSessions;\n\n  /** Export management */\n  public readonly exports: Exports;\n\n  /** Database connection management */\n  public readonly connections: Connections;\n\n  constructor(config: FerryConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? 'https://api.dataferry.dev';\n    this.timeout = config.timeout ?? 30000;\n\n    // Initialize resources\n    this.portalSessions = new PortalSessions(this);\n    this.exports = new Exports(this);\n    this.connections = new Connections(this);\n  }\n\n  /**\n   * Create a portal session for an end user to export their data.\n   *\n   * This is the primary method for initiating a data export. It creates a\n   * secure session and returns a URL where the user can select and download\n   * their data.\n   *\n   * @example\n   * ```typescript\n   * const ferry = new Ferry({ apiKey: 'your-api-key' });\n   *\n   * // Create a session for a specific user\n   * const session = await ferry.createPortalSession({\n   *   profile: 'default',\n   *   scopeId: 'user_123',\n   *   returnUrl: 'https://app.example.com/settings',\n   * });\n   *\n   * // Redirect the user to the portal\n   * res.redirect(session.url);\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Single-tenant mode (no scopeId required)\n   * const session = await ferry.createPortalSession({\n   *   profile: 'default',\n   *   returnUrl: 'https://app.example.com/settings',\n   * });\n   * ```\n   */\n  async createPortalSession(\n    params: CreatePortalSessionParams\n  ): Promise<PortalSessionResult> {\n    // Build request object, only including defined properties\n    // (required by exactOptionalPropertyTypes)\n    const request: {\n      profile: string;\n      scopeId?: string;\n      returnUrl?: string;\n      expiresIn?: number;\n      email?: string;\n      metadata?: Record<string, unknown>;\n    } = { profile: params.profile };\n\n    if (params.scopeId !== undefined) {\n      request.scopeId = params.scopeId;\n    }\n    if (params.returnUrl !== undefined) {\n      request.returnUrl = params.returnUrl;\n    }\n    if (params.expiresIn !== undefined) {\n      request.expiresIn = params.expiresIn;\n    }\n    if (params.email !== undefined) {\n      request.email = params.email;\n    }\n    if (params.metadata !== undefined) {\n      request.metadata = params.metadata;\n    }\n\n    const response = await this.portalSessions.create(request);\n\n    return {\n      id: response.id,\n      url: response.url,\n      expiresAt: response.expiresAt,\n    };\n  }\n\n  /**\n   * Make an authenticated API request\n   */\n  async request<T>(\n    method: string,\n    path: string,\n    body?: unknown\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      Authorization: `Basic ${Buffer.from(this.apiKey + ':').toString('base64')}`,\n    };\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const fetchOptions: RequestInit = {\n        method,\n        headers,\n        signal: controller.signal,\n      };\n      if (body) {\n        fetchOptions.body = JSON.stringify(body);\n      }\n      const response = await fetch(url, fetchOptions);\n\n      const data = (await response.json()) as ApiResponse<T>;\n\n      if (!response.ok || !data.success) {\n        const error = new FerryError(\n          data.error?.message ?? 'An error occurred',\n          data.error?.code ?? 'UNKNOWN_ERROR',\n          response.status\n        );\n        throw error;\n      }\n\n      return data.data!;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /**\n   * Make a paginated API request\n   */\n  async requestPaginated<T>(\n    path: string,\n    params?: Record<string, string | number | undefined>\n  ): Promise<{ data: T[]; meta: ApiResponse<T>['meta'] }> {\n    const searchParams = new URLSearchParams();\n    if (params) {\n      for (const [key, value] of Object.entries(params)) {\n        if (value !== undefined) {\n          searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const url = searchParams.toString() ? `${path}?${searchParams}` : path;\n\n    const response = await fetch(`${this.baseUrl}${url}`, {\n      headers: {\n        Authorization: `Basic ${Buffer.from(this.apiKey + ':').toString('base64')}`,\n      },\n    });\n\n    const result = (await response.json()) as ApiResponse<T[]>;\n\n    if (!response.ok || !result.success) {\n      throw new FerryError(\n        result.error?.message ?? 'An error occurred',\n        result.error?.code ?? 'UNKNOWN_ERROR',\n        response.status\n      );\n    }\n\n    return {\n      data: result.data!,\n      meta: result.meta,\n    };\n  }\n}\n\n/**\n * DataFerry SDK error\n */\nexport class FerryError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status: number\n  ) {\n    super(message);\n    this.name = 'FerryError';\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,534 @@
+/**
+ * DataFerry SDK types
+ *
+ * These types are inlined from @dataferry/common so the SDK
+ * has zero runtime and type-level dependencies.
+ */
+type ExportStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'expired';
+type ExportFormat = 'csv';
+interface ExportMetadata {
+    requestIp?: string;
+    userAgent?: string;
+    portalSessionId?: string;
+    custom?: Record<string, unknown>;
+}
+interface ExportJob {
+    id: string;
+    organizationId: string;
+    scopeId: string;
+    connectionId?: string;
+    status: ExportStatus;
+    format: ExportFormat;
+    selectedTables: string[];
+    storageKey: string | null;
+    downloadUrl: string | null;
+    downloadUrlExpiresAt: Date | null;
+    fileSizeBytes: number | null;
+    totalRows: number | null;
+    errorMessage: string | null;
+    errorCode: string | null;
+    createdAt: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    metadata: ExportMetadata;
+}
+interface CreateExportRequest {
+    scopeId: string;
+    connectionId?: string;
+    format?: ExportFormat;
+    tables?: string[];
+    webhookUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+interface PortalSession {
+    id: string;
+    organizationId: string;
+    scopeId: string;
+    profileId: string;
+    token: string;
+    expiresAt: Date;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+}
+interface CreatePortalSessionRequest {
+    profile: string;
+    scopeId?: string;
+    expiresIn?: number;
+    returnUrl?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreatePortalSessionResponse {
+    id: string;
+    url: string;
+    expiresAt: Date;
+}
+interface DatabaseConnection {
+    id: string;
+    organizationId: string;
+    name: string;
+    host: string;
+    port: string;
+    database: string;
+    user: string;
+    ssl: boolean;
+    lastTestedAt: Date | null;
+    lastTestSuccess: boolean | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateConnectionRequest {
+    name: string;
+    host: string;
+    port?: string;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean;
+}
+interface UpdateConnectionRequest {
+    name?: string;
+    host?: string;
+    port?: string;
+    database?: string;
+    user?: string;
+    password?: string;
+    ssl?: boolean;
+}
+interface TestConnectionResult {
+    connected: boolean;
+    database?: string;
+    user?: string;
+    error?: string;
+    responseTimeMs?: number;
+}
+type OwnershipMode = 'direct_column' | 'fk_chain';
+interface OwnershipEdge {
+    fromTable: string;
+    fromColumn: string;
+    toTable: string;
+    toColumn: string;
+    direction: 'direct' | 'inverse';
+}
+interface IncludedTable {
+    tableName: string;
+    label: string;
+    ownershipMode: OwnershipMode | null;
+    userColumn?: string;
+    ownershipPath?: OwnershipEdge[];
+    depth: number;
+    confidence: number;
+    includedColumns: string[] | null;
+    excludedColumns: string[];
+}
+interface TableGroup {
+    id: string;
+    label: string;
+    tableNames: string[];
+}
+interface SchemaConfig {
+    id: string;
+    organizationId: string;
+    anchorTable?: string;
+    anchorColumn?: string;
+    includedTables: IncludedTable[];
+    excludedTables: string[];
+    maxDepth: number;
+    createdAt: Date;
+    updatedAt: Date;
+    version: number;
+    groups?: TableGroup[];
+}
+type WebhookEvent = 'export.completed' | 'export.failed' | 'schema.updated';
+interface WebhookStats {
+    totalDeliveries: number;
+    successfulDeliveries: number;
+    failedDeliveries: number;
+    lastDeliveryAt: Date | null;
+    lastSuccessAt: Date | null;
+    lastFailureReason: string | null;
+}
+interface WebhookEndpoint {
+    id: string;
+    organizationId: string;
+    url: string;
+    events: WebhookEvent[];
+    secret: string;
+    active: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    stats: WebhookStats;
+}
+
+/**
+ * Portal Sessions resource
+ */
+
+declare class PortalSessions {
+    private readonly client;
+    constructor(client: Ferry);
+    /**
+     * Create a new portal session for an end user
+     *
+     * @example
+     * ```ts
+     * const session = await ferry.portalSessions.create({
+     *   profile: 'default',
+     *   scopeId: 'user_123',
+     *   expiresIn: 3600,
+     *   returnUrl: 'https://yourapp.com/settings',
+     * });
+     *
+     * // Redirect user to session.url
+     * ```
+     */
+    create(params: CreatePortalSessionRequest): Promise<CreatePortalSessionResponse>;
+    /**
+     * Get portal session details
+     *
+     * @example
+     * ```ts
+     * const session = await ferry.portalSessions.retrieve('ps_abc123');
+     * console.log(session.scopeId, session.expiresAt);
+     * ```
+     */
+    retrieve(sessionId: string): Promise<PortalSession & {
+        isExpired: boolean;
+    }>;
+    /**
+     * Revoke a portal session
+     *
+     * @example
+     * ```ts
+     * await ferry.portalSessions.revoke('ps_abc123');
+     * ```
+     */
+    revoke(sessionId: string): Promise<{
+        id: string;
+    }>;
+}
+
+/**
+ * Exports resource
+ */
+
+interface ExportResponse {
+    id: string;
+    status: ExportStatus;
+    scopeId: string;
+    /** Database connection ID used for this export */
+    connectionId?: string;
+    /** Database connection name (if connection still exists) */
+    connectionName?: string;
+    format: string;
+    tables: string[];
+    downloadUrl?: string;
+    downloadUrlExpiresAt?: string;
+    fileSizeBytes?: number;
+    totalRows?: number;
+    errorMessage?: string;
+    errorCode?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+interface ListExportsParams extends Record<string, string | number | undefined> {
+    scopeId?: string;
+    /** Filter by database connection ID */
+    connectionId?: string;
+    status?: ExportStatus;
+    page?: number;
+    limit?: number;
+}
+declare class Exports {
+    private readonly client;
+    constructor(client: Ferry);
+    /**
+     * Create a new export job
+     *
+     * @example
+     * ```ts
+     * // Create export using primary connection
+     * const exportJob = await ferry.exports.create({
+     *   scopeId: 'user_123',
+     *   format: 'csv',
+     *   tables: ['users', 'posts', 'comments'],
+     * });
+     *
+     * // Create export using specific connection
+     * const exportJob = await ferry.exports.create({
+     *   scopeId: 'user_123',
+     *   connectionId: 'conn_abc123',
+     *   format: 'csv',
+     *   tables: ['users', 'posts'],
+     * });
+     *
+     * console.log(exportJob.id, exportJob.status);
+     * ```
+     */
+    create(params: CreateExportRequest): Promise<ExportResponse>;
+    /**
+     * Get export job details
+     *
+     * @example
+     * ```ts
+     * const exportJob = await ferry.exports.retrieve('exp_abc123');
+     *
+     * if (exportJob.status === 'completed') {
+     *   console.log('Download:', exportJob.downloadUrl);
+     * }
+     * ```
+     */
+    retrieve(exportId: string): Promise<ExportResponse>;
+    /**
+     * List exports
+     *
+     * @example
+     * ```ts
+     * // List all exports
+     * const { data, meta } = await ferry.exports.list();
+     *
+     * // Filter by scope
+     * const { data } = await ferry.exports.list({ scopeId: 'user_123' });
+     *
+     * // Filter by status
+     * const { data } = await ferry.exports.list({ status: 'completed' });
+     *
+     * // Filter by connection
+     * const { data } = await ferry.exports.list({ connectionId: 'conn_abc123' });
+     * ```
+     */
+    list(params?: ListExportsParams): Promise<{
+        data: ExportResponse[];
+        meta: {
+            page: number;
+            limit: number;
+            total: number;
+            totalPages: number;
+        } | undefined;
+    }>;
+    /**
+     * Wait for an export to complete
+     *
+     * @example
+     * ```ts
+     * const exportJob = await ferry.exports.create({ scopeId: 'user_123' });
+     * const completed = await ferry.exports.poll(exportJob.id, { maxWait: 300000 });
+     *
+     * if (completed.status === 'completed') {
+     *   console.log('Download:', completed.downloadUrl);
+     * }
+     * ```
+     */
+    poll(exportId: string, options?: {
+        maxWait?: number;
+        interval?: number;
+    }): Promise<ExportResponse>;
+}
+
+/**
+ * Database Connections resource
+ */
+
+declare class Connections {
+    private readonly client;
+    constructor(client: Ferry);
+    /**
+     * List all database connections for the organization
+     *
+     * @example
+     * ```ts
+     * const connections = await ferry.connections.list();
+     * for (const conn of connections) {
+     *   console.log(conn.name);
+     * }
+     * ```
+     */
+    list(): Promise<DatabaseConnection[]>;
+    /**
+     * Create a new database connection
+     *
+     * @example
+     * ```ts
+     * const connection = await ferry.connections.create({
+     *   name: 'Production DB',
+     *   host: 'db.example.com',
+     *   port: '5432',
+     *   database: 'myapp',
+     *   user: 'ferry_readonly',
+     *   password: 'secret',
+     *   ssl: true,
+     * });
+     * ```
+     */
+    create(params: CreateConnectionRequest): Promise<DatabaseConnection>;
+    /**
+     * Get a database connection by ID
+     *
+     * @example
+     * ```ts
+     * const connection = await ferry.connections.retrieve('conn_abc123');
+     * console.log(connection.host, connection.database);
+     * ```
+     */
+    retrieve(connectionId: string): Promise<DatabaseConnection>;
+    /**
+     * Update a database connection
+     *
+     * @example
+     * ```ts
+     * const connection = await ferry.connections.update('conn_abc123', {
+     *   name: 'Production DB (Updated)',
+     * });
+     * ```
+     */
+    update(connectionId: string, params: UpdateConnectionRequest): Promise<DatabaseConnection>;
+    /**
+     * Delete a database connection
+     *
+     * @example
+     * ```ts
+     * const result = await ferry.connections.delete('conn_abc123');
+     * console.log(result.deleted); // true
+     * ```
+     */
+    delete(connectionId: string): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+    /**
+     * Test a database connection
+     *
+     * @example
+     * ```ts
+     * const result = await ferry.connections.test('conn_abc123');
+     * if (result.connected) {
+     *   console.log(`Connected to ${result.database} as ${result.user}`);
+     * } else {
+     *   console.error(`Connection failed: ${result.error}`);
+     * }
+     * ```
+     */
+    test(connectionId: string): Promise<TestConnectionResult>;
+}
+
+/**
+ * DataFerry SDK client
+ */
+
+interface FerryConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the DataFerry API (default: https://api.dataferry.dev) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    meta?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+/**
+ * Parameters for creating a portal session
+ */
+interface CreatePortalSessionParams {
+    /** Export profile name (required) */
+    profile: string;
+    /** The scope ID for data filtering (optional for single-tenant mode) */
+    scopeId?: string;
+    /** Return URL after export completes */
+    returnUrl?: string;
+    /** Custom session duration in seconds (default: 3600) */
+    expiresIn?: number;
+    /** End-user email for export completion notifications */
+    email?: string;
+    /** Custom metadata to attach to the session */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Portal session response
+ */
+interface PortalSessionResult {
+    /** Session ID */
+    id: string;
+    /** URL to redirect the user to */
+    url: string;
+    /** When the session expires */
+    expiresAt: Date;
+}
+declare class Ferry {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    /** Portal session management */
+    readonly portalSessions: PortalSessions;
+    /** Export management */
+    readonly exports: Exports;
+    /** Database connection management */
+    readonly connections: Connections;
+    constructor(config: FerryConfig);
+    /**
+     * Create a portal session for an end user to export their data.
+     *
+     * This is the primary method for initiating a data export. It creates a
+     * secure session and returns a URL where the user can select and download
+     * their data.
+     *
+     * @example
+     * ```typescript
+     * const ferry = new Ferry({ apiKey: 'your-api-key' });
+     *
+     * // Create a session for a specific user
+     * const session = await ferry.createPortalSession({
+     *   profile: 'default',
+     *   scopeId: 'user_123',
+     *   returnUrl: 'https://app.example.com/settings',
+     * });
+     *
+     * // Redirect the user to the portal
+     * res.redirect(session.url);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Single-tenant mode (no scopeId required)
+     * const session = await ferry.createPortalSession({
+     *   profile: 'default',
+     *   returnUrl: 'https://app.example.com/settings',
+     * });
+     * ```
+     */
+    createPortalSession(params: CreatePortalSessionParams): Promise<PortalSessionResult>;
+    /**
+     * Make an authenticated API request
+     */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    /**
+     * Make a paginated API request
+     */
+    requestPaginated<T>(path: string, params?: Record<string, string | number | undefined>): Promise<{
+        data: T[];
+        meta: ApiResponse<T>['meta'];
+    }>;
+}
+/**
+ * DataFerry SDK error
+ */
+declare class FerryError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code: string, status: number);
+}
+
+export { Connections, type CreateConnectionRequest, type CreateExportRequest, type CreatePortalSessionParams, type CreatePortalSessionRequest, type CreatePortalSessionResponse, type DatabaseConnection, type ExportFormat, type ExportJob, type ExportStatus, Exports, Ferry, type FerryConfig, FerryError, type PortalSessionResult, PortalSessions, type SchemaConfig, type TestConnectionResult, type UpdateConnectionRequest, type WebhookEndpoint, type WebhookEvent };