@dataferry/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,433 @@
+// src/resources/portalSessions.ts
+var PortalSessions = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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
+   * ```
+   */
+  async create(params) {
+    return this.client.request(
+      "POST",
+      "/api/v1/portal-sessions",
+      params
+    );
+  }
+  /**
+   * Get portal session details
+   *
+   * @example
+   * ```ts
+   * const session = await ferry.portalSessions.retrieve('ps_abc123');
+   * console.log(session.scopeId, session.expiresAt);
+   * ```
+   */
+  async retrieve(sessionId) {
+    return this.client.request(
+      "GET",
+      `/api/v1/portal-sessions/${sessionId}`
+    );
+  }
+  /**
+   * Revoke a portal session
+   *
+   * @example
+   * ```ts
+   * await ferry.portalSessions.revoke('ps_abc123');
+   * ```
+   */
+  async revoke(sessionId) {
+    return this.client.request(
+      "DELETE",
+      `/api/v1/portal-sessions/${sessionId}`
+    );
+  }
+};
+
+// src/resources/exports.ts
+var Exports = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 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);
+   * ```
+   */
+  async create(params) {
+    return this.client.request(
+      "POST",
+      "/api/v1/exports",
+      params
+    );
+  }
+  /**
+   * Get export job details
+   *
+   * @example
+   * ```ts
+   * const exportJob = await ferry.exports.retrieve('exp_abc123');
+   *
+   * if (exportJob.status === 'completed') {
+   *   console.log('Download:', exportJob.downloadUrl);
+   * }
+   * ```
+   */
+  async retrieve(exportId) {
+    return this.client.request(
+      "GET",
+      `/api/v1/exports/${exportId}`
+    );
+  }
+  /**
+   * 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' });
+   * ```
+   */
+  async list(params) {
+    return this.client.requestPaginated(
+      "/api/v1/exports",
+      params
+    );
+  }
+  /**
+   * 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);
+   * }
+   * ```
+   */
+  async poll(exportId, options = {}) {
+    const maxWait = options.maxWait ?? 3e5;
+    const interval = options.interval ?? 2e3;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait) {
+      const exportJob = await this.retrieve(exportId);
+      if (exportJob.status === "completed" || exportJob.status === "failed" || exportJob.status === "expired") {
+        return exportJob;
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    throw new Error(`Export ${exportId} did not complete within ${maxWait}ms`);
+  }
+};
+
+// src/resources/connections.ts
+var Connections = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all database connections for the organization
+   *
+   * @example
+   * ```ts
+   * const connections = await ferry.connections.list();
+   * for (const conn of connections) {
+   *   console.log(conn.name);
+   * }
+   * ```
+   */
+  async list() {
+    const result = await this.client.requestPaginated(
+      "/api/v1/connections"
+    );
+    return result.data;
+  }
+  /**
+   * 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,
+   * });
+   * ```
+   */
+  async create(params) {
+    return this.client.request(
+      "POST",
+      "/api/v1/connections",
+      params
+    );
+  }
+  /**
+   * Get a database connection by ID
+   *
+   * @example
+   * ```ts
+   * const connection = await ferry.connections.retrieve('conn_abc123');
+   * console.log(connection.host, connection.database);
+   * ```
+   */
+  async retrieve(connectionId) {
+    return this.client.request(
+      "GET",
+      `/api/v1/connections/${connectionId}`
+    );
+  }
+  /**
+   * Update a database connection
+   *
+   * @example
+   * ```ts
+   * const connection = await ferry.connections.update('conn_abc123', {
+   *   name: 'Production DB (Updated)',
+   * });
+   * ```
+   */
+  async update(connectionId, params) {
+    return this.client.request(
+      "PUT",
+      `/api/v1/connections/${connectionId}`,
+      params
+    );
+  }
+  /**
+   * Delete a database connection
+   *
+   * @example
+   * ```ts
+   * const result = await ferry.connections.delete('conn_abc123');
+   * console.log(result.deleted); // true
+   * ```
+   */
+  async delete(connectionId) {
+    return this.client.request(
+      "DELETE",
+      `/api/v1/connections/${connectionId}`
+    );
+  }
+  /**
+   * 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}`);
+   * }
+   * ```
+   */
+  async test(connectionId) {
+    return this.client.request(
+      "POST",
+      `/api/v1/connections/${connectionId}/test`
+    );
+  }
+};
+
+// src/client.ts
+var Ferry = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  /** Portal session management */
+  portalSessions;
+  /** Export management */
+  exports;
+  /** Database connection management */
+  connections;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.dataferry.dev";
+    this.timeout = config.timeout ?? 3e4;
+    this.portalSessions = new PortalSessions(this);
+    this.exports = new Exports(this);
+    this.connections = new Connections(this);
+  }
+  /**
+   * 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',
+   * });
+   * ```
+   */
+  async createPortalSession(params) {
+    const request = { profile: params.profile };
+    if (params.scopeId !== void 0) {
+      request.scopeId = params.scopeId;
+    }
+    if (params.returnUrl !== void 0) {
+      request.returnUrl = params.returnUrl;
+    }
+    if (params.expiresIn !== void 0) {
+      request.expiresIn = params.expiresIn;
+    }
+    if (params.email !== void 0) {
+      request.email = params.email;
+    }
+    if (params.metadata !== void 0) {
+      request.metadata = params.metadata;
+    }
+    const response = await this.portalSessions.create(request);
+    return {
+      id: response.id,
+      url: response.url,
+      expiresAt: response.expiresAt
+    };
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      Authorization: `Basic ${Buffer.from(this.apiKey + ":").toString("base64")}`
+    };
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const fetchOptions = {
+        method,
+        headers,
+        signal: controller.signal
+      };
+      if (body) {
+        fetchOptions.body = JSON.stringify(body);
+      }
+      const response = await fetch(url, fetchOptions);
+      const data = await response.json();
+      if (!response.ok || !data.success) {
+        const error = new FerryError(
+          data.error?.message ?? "An error occurred",
+          data.error?.code ?? "UNKNOWN_ERROR",
+          response.status
+        );
+        throw error;
+      }
+      return data.data;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Make a paginated API request
+   */
+  async requestPaginated(path, params) {
+    const searchParams = new URLSearchParams();
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0) {
+          searchParams.set(key, String(value));
+        }
+      }
+    }
+    const url = searchParams.toString() ? `${path}?${searchParams}` : path;
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      headers: {
+        Authorization: `Basic ${Buffer.from(this.apiKey + ":").toString("base64")}`
+      }
+    });
+    const result = await response.json();
+    if (!response.ok || !result.success) {
+      throw new FerryError(
+        result.error?.message ?? "An error occurred",
+        result.error?.code ?? "UNKNOWN_ERROR",
+        response.status
+      );
+    }
+    return {
+      data: result.data,
+      meta: result.meta
+    };
+  }
+};
+var FerryError = class extends Error {
+  constructor(message, code, status) {
+    super(message);
+    this.code = code;
+    this.status = status;
+    this.name = "FerryError";
+  }
+};
+export {
+  Connections,
+  Exports,
+  Ferry,
+  FerryError,
+  PortalSessions
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/portalSessions.ts","../src/resources/exports.ts","../src/resources/connections.ts","../src/client.ts"],"sourcesContent":["/**\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/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@dataferry/sdk",
+  "version": "0.1.0",
+  "description": "Node.js SDK for DataFerry - data export infrastructure for SaaS companies",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.3"
+  },
+  "keywords": [
+    "dataferry",
+    "ferry",
+    "data-export",
+    "gdpr",
+    "ccpa",
+    "data-portability",
+    "data-rights"
+  ]
+}