@stagware/nocodb-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2118 @@
+/**
+ * Type definitions for NocoDB API entities.
+ *
+ * This module provides TypeScript interfaces for all core NocoDB entities
+ * including bases, tables, views, columns, filters, sorts, and rows.
+ */
+/**
+ * Represents a NocoDB base (database/project).
+ */
+interface Base {
+    /** Unique identifier for the base */
+    id: string;
+    /** Display title of the base */
+    title: string;
+    /** Type of the base (e.g., 'database') */
+    type?: string;
+    /** Whether this is a meta base */
+    is_meta?: boolean;
+    /** Base description */
+    description?: string;
+    /** Base color (hex string) */
+    color?: string;
+    /** Display order of the base */
+    order?: number;
+    /** Base status */
+    status?: string;
+    /** Table name prefix */
+    prefix?: string;
+    /** Whether the base is deleted (soft delete) */
+    deleted?: boolean;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+    /** Data sources associated with this base */
+    sources?: Source[];
+    /** Whether the base is external */
+    external?: boolean;
+    /** Timestamp when the base was created */
+    created_at?: string;
+    /** Timestamp when the base was last updated */
+    updated_at?: string;
+}
+/**
+ * Supported source/connection types in NocoDB.
+ */
+type SourceType = 'mysql2' | 'pg' | 'sqlite3' | 'mssql' | 'snowflake' | 'databricks';
+/**
+ * Represents a data source (database connection) within a NocoDB base.
+ */
+interface Source {
+    /** Unique identifier for the source */
+    id: string;
+    /** ID of the base this source belongs to */
+    base_id: string;
+    /** Display alias for the source */
+    alias?: string;
+    /** Source type (database driver) */
+    type?: SourceType | string;
+    /** Whether the source is enabled */
+    enabled?: boolean;
+    /** Whether this is the meta source */
+    is_meta?: boolean;
+    /** Connection configuration (encrypted) */
+    config?: Record<string, unknown> | string | null;
+    /** Column name inflection rule */
+    inflection_column?: string;
+    /** Table name inflection rule */
+    inflection_table?: string;
+    /** Display order of the source */
+    order?: number;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+    /** Timestamp when the source was created */
+    created_at?: string;
+    /** Timestamp when the source was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a table within a NocoDB base.
+ */
+interface Table {
+    /** Unique identifier for the table */
+    id: string;
+    /** ID of the base this table belongs to */
+    base_id: string;
+    /** Display title of the table */
+    title: string;
+    /** Actual database table name */
+    table_name: string;
+    /** Type of the table */
+    type?: string;
+    /** Whether the table is enabled */
+    enabled?: boolean;
+    /** Display order of the table */
+    order?: number;
+    /** Columns in this table */
+    columns?: Column[];
+    /** Timestamp when the table was created */
+    created_at?: string;
+    /** Timestamp when the table was last updated */
+    updated_at?: string;
+}
+/**
+ * Supported view types in NocoDB.
+ */
+type ViewType = 'grid' | 'form' | 'gallery' | 'kanban' | 'calendar';
+/**
+ * Represents a view of a table (grid, form, gallery, etc.).
+ */
+interface View {
+    /** Unique identifier for the view */
+    id: string;
+    /** Display title of the view */
+    title: string;
+    /** Type of the view */
+    type: ViewType;
+    /** ID of the table this view belongs to */
+    fk_model_id: string;
+    /** Whether the view is visible */
+    show?: boolean;
+    /** Display order of the view */
+    order?: number;
+    /** Timestamp when the view was created */
+    created_at?: string;
+    /** Timestamp when the view was last updated */
+    updated_at?: string;
+}
+/**
+ * Supported column types in NocoDB.
+ *
+ * Includes basic types (text, number, date), advanced types (formula, lookup),
+ * and special types (attachments, links).
+ */
+type ColumnType = 'SingleLineText' | 'LongText' | 'Number' | 'Decimal' | 'Currency' | 'Percent' | 'Duration' | 'Rating' | 'Date' | 'DateTime' | 'Time' | 'Year' | 'Checkbox' | 'SingleSelect' | 'MultiSelect' | 'Email' | 'URL' | 'PhoneNumber' | 'LinkToAnotherRecord' | 'Lookup' | 'Rollup' | 'Formula' | 'Attachment' | 'Barcode' | 'QrCode' | 'JSON';
+/**
+ * Represents a column in a table.
+ */
+interface Column {
+    /** Unique identifier for the column */
+    id: string;
+    /** Display title of the column */
+    title: string;
+    /** Actual database column name */
+    column_name: string;
+    /** UI data type of the column */
+    uidt: ColumnType;
+    /** Database data type */
+    dt?: string;
+    /** Whether this is a primary key column */
+    pk?: boolean;
+    /** Whether this is a primary value column */
+    pv?: boolean;
+    /** Whether this column is required */
+    rqd?: boolean;
+    /** Whether this is a system column */
+    system?: boolean;
+    /** ID of the table this column belongs to */
+    fk_model_id: string;
+    /** Timestamp when the column was created */
+    created_at?: string;
+    /** Timestamp when the column was last updated */
+    updated_at?: string;
+}
+/**
+ * Comparison operators for filter conditions.
+ *
+ * Includes equality, comparison, pattern matching, and set operations.
+ */
+type ComparisonOperator = 'eq' | 'neq' | 'like' | 'nlike' | 'empty' | 'notempty' | 'null' | 'notnull' | 'gt' | 'lt' | 'gte' | 'lte' | 'allof' | 'anyof' | 'nallof' | 'nanyof';
+/**
+ * Represents a filter condition on a view.
+ *
+ * Filters can be simple conditions or groups of conditions combined with
+ * logical operators (AND/OR).
+ */
+interface Filter {
+    /** Unique identifier for the filter */
+    id: string;
+    /** ID of the view this filter belongs to */
+    fk_view_id: string;
+    /** ID of the column to filter on (not set for filter groups) */
+    fk_column_id?: string;
+    /** Logical operator for combining filters (and/or) */
+    logical_op?: 'and' | 'or';
+    /** Comparison operator for the filter condition */
+    comparison_op?: ComparisonOperator;
+    /** Value to compare against */
+    value?: string | number | boolean | null;
+    /** ID of the parent filter group (for nested filters) */
+    fk_parent_id?: string;
+    /** Whether this is a filter group */
+    is_group?: boolean;
+    /** Timestamp when the filter was created */
+    created_at?: string;
+    /** Timestamp when the filter was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a sort order on a view.
+ */
+interface Sort {
+    /** Unique identifier for the sort */
+    id: string;
+    /** ID of the view this sort belongs to */
+    fk_view_id: string;
+    /** ID of the column to sort by */
+    fk_column_id: string;
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+    /** Order of this sort in the sort list */
+    order?: number;
+    /** Timestamp when the sort was created */
+    created_at?: string;
+    /** Timestamp when the sort was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a webhook/hook on a table.
+ */
+interface Hook {
+    /** Unique identifier for the hook */
+    id: string;
+    /** ID of the table this hook belongs to */
+    fk_model_id: string;
+    /** Display title of the hook */
+    title: string;
+    /** Description of the hook */
+    description?: string;
+    /** Event type (after/before) */
+    event: 'after' | 'before';
+    /** Operation that triggers the hook */
+    operation: 'insert' | 'update' | 'delete' | 'bulkInsert' | 'bulkUpdate' | 'bulkDelete';
+    /** Whether the hook is active */
+    active?: boolean;
+    /** Notification configuration (URL, method, headers, body, etc.) */
+    notification?: Record<string, unknown>;
+    /** Retry count on failure */
+    retries?: number;
+    /** Retry interval in milliseconds */
+    retry_interval?: number;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Timestamp when the hook was created */
+    created_at?: string;
+    /** Timestamp when the hook was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents an API token.
+ */
+interface ApiToken {
+    /** Unique identifier for the token */
+    id?: string;
+    /** Token string */
+    token?: string;
+    /** Description/label for the token */
+    description?: string;
+    /** ID of the user who created the token */
+    fk_user_id?: string;
+    /** Timestamp when the token was created */
+    created_at?: string;
+    /** Timestamp when the token was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a user associated with a base (collaborator).
+ */
+interface BaseUser {
+    /** Unique identifier for the user */
+    id?: string;
+    /** User email address */
+    email: string;
+    /** User display name */
+    display_name?: string;
+    /** User role in the base */
+    roles?: string;
+    /** Timestamp when the user was created */
+    created_at?: string;
+    /** Timestamp when the user was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a comment on a row.
+ */
+interface Comment {
+    /** Unique identifier for the comment */
+    id: string;
+    /** ID of the row this comment belongs to */
+    row_id: string;
+    /** ID of the table (model) this comment belongs to */
+    fk_model_id: string;
+    /** Comment text content */
+    comment?: string;
+    /** ID of the user who created the comment */
+    created_by?: string;
+    /** Email of the user who created the comment */
+    created_by_email?: string;
+    /** ID of the user who resolved the comment */
+    resolved_by?: string;
+    /** Timestamp when the comment was created */
+    created_at?: string;
+    /** Timestamp when the comment was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a shared view (public link to a view).
+ */
+interface SharedView {
+    /** Unique identifier for the shared view */
+    id: string;
+    /** ID of the view being shared */
+    fk_view_id: string;
+    /** Password protection for the shared view */
+    password?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+    /** Timestamp when the shared view was created */
+    created_at?: string;
+    /** Timestamp when the shared view was last updated */
+    updated_at?: string;
+}
+/**
+ * Represents a shared base (public link to an entire base).
+ */
+interface SharedBase {
+    /** UUID for the shared base link */
+    uuid?: string;
+    /** Public URL for the shared base */
+    url?: string;
+    /** Roles granted to shared base users */
+    roles?: string;
+    /** Password protection for the shared base */
+    password?: string;
+}
+/**
+ * Represents a column's settings within a specific view.
+ */
+interface ViewColumn {
+    /** Unique identifier for the view column */
+    id: string;
+    /** ID of the view */
+    fk_view_id: string;
+    /** ID of the column */
+    fk_column_id: string;
+    /** Whether the column is visible in this view */
+    show?: boolean;
+    /** Display order of the column in this view */
+    order?: number;
+    /** Column width (for grid views) */
+    width?: string;
+}
+/**
+ * Form view-specific configuration.
+ */
+interface FormView {
+    /** Unique identifier */
+    id?: string;
+    /** Form heading */
+    heading?: string;
+    /** Form subheading */
+    subheading?: string;
+    /** Success message after form submission */
+    success_msg?: string;
+    /** Redirect URL after form submission */
+    redirect_url?: string;
+    /** Whether to show a banner image */
+    banner_image_url?: string;
+    /** Whether to show the logo */
+    logo_url?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+}
+/**
+ * Gallery view-specific configuration.
+ */
+interface GalleryView {
+    /** Unique identifier */
+    id?: string;
+    /** ID of the cover image column */
+    fk_cover_image_col_id?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+}
+/**
+ * Kanban view-specific configuration.
+ */
+interface KanbanView {
+    /** Unique identifier */
+    id?: string;
+    /** ID of the grouping column */
+    fk_grp_col_id?: string;
+    /** ID of the cover image column */
+    fk_cover_image_col_id?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+}
+/**
+ * Grid view-specific configuration.
+ */
+interface GridView {
+    /** Unique identifier */
+    id?: string;
+    /** Row height setting */
+    row_height?: number;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+}
+/**
+ * NocoDB server application info.
+ */
+interface AppInfo {
+    /** NocoDB version */
+    version?: string;
+    /** Authentication type */
+    authType?: string;
+    /** Whether the instance is a Docker deployment */
+    isDocker?: boolean;
+    /** Default language */
+    defaultLanguage?: string;
+    /** Project page default limit */
+    projectPageDefaultLimit?: number;
+    /** Whether invite-only signup is enabled */
+    inviteOnlySignup?: boolean;
+    /** Type of the NocoDB instance */
+    type?: string;
+    /** First user email (if applicable) */
+    firstUser?: string;
+    /** Whether telemetry is enabled */
+    telemetry?: boolean;
+    /** Whether audit is enabled */
+    auditEnabled?: boolean;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * Visibility rule for a view (UI ACL).
+ */
+interface VisibilityRule {
+    /** View ID */
+    id?: string;
+    /** View title */
+    title?: string;
+    /** Table ID */
+    fk_model_id?: string;
+    /** View type */
+    type?: number;
+    /** Whether the view is disabled for the role */
+    disabled?: Record<string, boolean>;
+    /** Display order */
+    order?: number;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * Options for duplicate operations.
+ */
+interface DuplicateOptions {
+    /** Exclude row data from the duplicate */
+    excludeData?: boolean;
+    /** Exclude views from the duplicate */
+    excludeViews?: boolean;
+    /** Exclude hooks/webhooks from the duplicate */
+    excludeHooks?: boolean;
+}
+/**
+ * Represents a NocoDB Cloud workspace (☁ cloud-only).
+ *
+ * Workspaces are organizational containers for bases in NocoDB Cloud.
+ * Self-hosted NocoDB does not have workspaces.
+ */
+interface NcWorkspace {
+    /** Unique identifier for the workspace */
+    id: string;
+    /** Display title of the workspace */
+    title?: string;
+    /** Workspace description */
+    description?: string;
+    /** ID of the user who owns the workspace */
+    fk_user_id?: string;
+    /** ID of the organization */
+    fk_org_id?: string;
+    /** Display order */
+    order?: number;
+    /** Whether the workspace is deleted (soft delete) */
+    deleted?: boolean;
+    /** Whether SSO-only access is enforced */
+    sso_only_access?: boolean;
+    /** Additional metadata */
+    meta?: Record<string, unknown> | string | null;
+    /** Timestamp when the workspace was created */
+    created_at?: string;
+    /** Timestamp when the workspace was last updated */
+    updated_at?: string;
+    /** Timestamp when the workspace was deleted */
+    deleted_at?: string;
+}
+/**
+ * Represents a user within a NocoDB Cloud workspace (☁ cloud-only).
+ */
+interface NcWorkspaceUser {
+    /** User email address */
+    email?: string;
+    /** ID of the user */
+    fk_user_id?: string;
+    /** Whether the user has accepted the invite */
+    invite_accepted?: boolean;
+    /** Invite token (for pending invitations) */
+    invite_token?: string;
+    /** User role in the workspace */
+    roles?: string;
+}
+/**
+ * Represents a row of data in a table.
+ *
+ * Rows have an Id field and arbitrary additional fields based on the table schema.
+ */
+interface Row {
+    /** Unique identifier for the row (may be string or number depending on PK type) */
+    Id?: string | number;
+    /** Additional fields based on table columns */
+    [key: string]: unknown;
+}
+
+/**
+ * Type definitions for NocoDB API responses.
+ *
+ * This module provides TypeScript interfaces for API response structures
+ * including paginated lists, bulk operations, and error responses.
+ */
+
+/**
+ * Pagination metadata for list responses.
+ *
+ * Provides information about the current page, total rows, and navigation state.
+ */
+interface PageInfo {
+    /** Total number of rows across all pages */
+    totalRows?: number;
+    /** Current page number (1-indexed) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Whether this is the first page */
+    isFirstPage?: boolean;
+    /** Whether this is the last page */
+    isLastPage?: boolean;
+}
+/**
+ * Generic paginated list response.
+ *
+ * Used for endpoints that return lists of items with pagination support.
+ *
+ * @template T - The type of items in the list
+ *
+ * @example
+ * ```typescript
+ * const response: ListResponse<Table> = await client.listTables(baseId);
+ * console.log(`Found ${response.pageInfo.totalRows} tables`);
+ * for (const table of response.list) {
+ *   console.log(table.title);
+ * }
+ * ```
+ */
+interface ListResponse<T> {
+    /** Array of items in the current page */
+    list: T[];
+    /** Pagination metadata */
+    pageInfo: PageInfo;
+}
+/**
+ * Response from bulk create operations.
+ *
+ * Indicates how many rows were successfully created and optionally
+ * includes the created row data.
+ */
+interface BulkCreateResponse {
+    /** Number of rows successfully created */
+    created: number;
+    /** Optional array of created row data */
+    data?: Row[];
+}
+/**
+ * Response from bulk update operations.
+ *
+ * Indicates how many rows were successfully updated and optionally
+ * includes the updated row data.
+ */
+interface BulkUpdateResponse {
+    /** Number of rows successfully updated */
+    updated: number;
+    /** Optional array of updated row data */
+    data?: Row[];
+}
+/**
+ * Response from bulk delete operations.
+ *
+ * Indicates how many rows were successfully deleted.
+ */
+interface BulkDeleteResponse {
+    /** Number of rows successfully deleted */
+    deleted: number;
+}
+/**
+ * Details about a failed item in a bulk operation.
+ *
+ * Provides information about which item failed and why.
+ */
+interface BulkOperationError {
+    /** Index of the failed item in the input array */
+    index: number;
+    /** The item that failed */
+    item: Row;
+    /** Error message describing the failure */
+    error: string;
+    /** Error code if available */
+    code?: string;
+}
+/**
+ * Enhanced response from bulk create operations with error tracking.
+ *
+ * Includes success/failure counts and details about failed items.
+ */
+interface BulkCreateResponseWithErrors extends BulkCreateResponse {
+    /** Number of rows that failed to create */
+    failed?: number;
+    /** Details about failed items */
+    errors?: BulkOperationError[];
+}
+/**
+ * Enhanced response from bulk update operations with error tracking.
+ *
+ * Includes success/failure counts and details about failed items.
+ */
+interface BulkUpdateResponseWithErrors extends BulkUpdateResponse {
+    /** Number of rows that failed to update */
+    failed?: number;
+    /** Details about failed items */
+    errors?: BulkOperationError[];
+}
+/**
+ * Enhanced response from bulk delete operations with error tracking.
+ *
+ * Includes success/failure counts and details about failed items.
+ */
+interface BulkDeleteResponseWithErrors extends BulkDeleteResponse {
+    /** Number of rows that failed to delete */
+    failed?: number;
+    /** Details about failed items */
+    errors?: BulkOperationError[];
+}
+/**
+ * Error response structure from NocoDB API.
+ *
+ * The API may return error messages in different fields depending
+ * on the endpoint and error type.
+ */
+interface ErrorResponse {
+    /** Error message (some endpoints use 'msg') */
+    msg?: string;
+    /** Error message (some endpoints use 'message') */
+    message?: string;
+    /** Error message (some endpoints use 'error') */
+    error?: string;
+}
+
+/**
+ * Base error class for all NocoDB SDK errors.
+ * Provides structured error information including error codes, status codes, and additional data.
+ */
+declare class NocoDBError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    data?: unknown | undefined;
+    /**
+     * Creates a new NocoDBError instance.
+     *
+     * @param message - Human-readable error message
+     * @param code - Machine-readable error code for programmatic handling
+     * @param statusCode - HTTP status code if applicable
+     * @param data - Additional error data (e.g., response body, validation details)
+     *
+     * @example
+     * ```typescript
+     * throw new NocoDBError('Operation failed', 'OPERATION_FAILED', 500, { details: 'Server error' });
+     * ```
+     */
+    constructor(message: string, code: string, statusCode?: number | undefined, data?: unknown | undefined);
+}
+/**
+ * Error thrown when network connectivity issues occur.
+ * This includes connection timeouts, DNS failures, and other network-level problems.
+ */
+declare class NetworkError extends NocoDBError {
+    /**
+     * Creates a new NetworkError instance.
+     *
+     * @param message - Human-readable error message
+     * @param cause - The underlying error that caused this network error
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await fetch('https://api.example.com');
+     * } catch (err) {
+     *   throw new NetworkError('Failed to connect to server', err);
+     * }
+     * ```
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when authentication or authorization fails.
+ * This includes invalid tokens, expired credentials, and insufficient permissions.
+ */
+declare class AuthenticationError extends NocoDBError {
+    /**
+     * Creates a new AuthenticationError instance.
+     *
+     * @param message - Human-readable error message
+     * @param statusCode - HTTP status code (typically 401 or 403)
+     * @param data - Additional error data from the server response
+     *
+     * @example
+     * ```typescript
+     * throw new AuthenticationError('Invalid API token', 401, { error: 'Token expired' });
+     * ```
+     */
+    constructor(message: string, statusCode: number, data?: unknown);
+}
+/**
+ * Error thrown when request validation fails.
+ * This includes schema validation errors, missing required fields, and invalid field values.
+ */
+declare class ValidationError extends NocoDBError {
+    fieldErrors?: Record<string, string[]> | undefined;
+    /**
+     * Creates a new ValidationError instance.
+     *
+     * @param message - Human-readable error message
+     * @param fieldErrors - Optional map of field names to validation error messages
+     *
+     * @example
+     * ```typescript
+     * throw new ValidationError('Invalid request data', {
+     *   email: ['Must be a valid email address'],
+     *   age: ['Must be a positive number']
+     * });
+     * ```
+     */
+    constructor(message: string, fieldErrors?: Record<string, string[]> | undefined);
+}
+/**
+ * Error thrown when a requested resource is not found.
+ * This typically corresponds to HTTP 404 responses.
+ */
+declare class NotFoundError extends NocoDBError {
+    /**
+     * Creates a new NotFoundError instance.
+     *
+     * @param resource - The type of resource that was not found (e.g., 'Base', 'Table', 'Row')
+     * @param id - The identifier of the resource that was not found
+     *
+     * @example
+     * ```typescript
+     * throw new NotFoundError('Table', 'tbl_abc123');
+     * // Error message: "Table not found: tbl_abc123"
+     * ```
+     */
+    constructor(resource: string, id: string);
+}
+/**
+ * Error thrown when a resource conflict occurs.
+ * This includes duplicate key violations, concurrent modification conflicts, and other state conflicts.
+ */
+declare class ConflictError extends NocoDBError {
+    /**
+     * Creates a new ConflictError instance.
+     *
+     * @param message - Human-readable error message
+     * @param data - Additional error data from the server response
+     *
+     * @example
+     * ```typescript
+     * throw new ConflictError('Row already exists with this unique key', { key: 'email', value: 'user@example.com' });
+     * ```
+     */
+    constructor(message: string, data?: unknown);
+}
+
+/**
+ * Map of HTTP header names to values.
+ */
+type HeadersMap = Record<string, string>;
+/**
+ * Configuration options for request retry behavior.
+ */
+interface RetryOptions {
+    /** Number of retry attempts, or false to disable retries */
+    retry?: number | false;
+    /** Delay in milliseconds between retry attempts */
+    retryDelay?: number;
+    /** HTTP status codes that should trigger a retry */
+    retryStatusCodes?: number[];
+}
+/**
+ * Options for individual HTTP requests.
+ */
+interface RequestOptions {
+    /** Additional headers to include in the request */
+    headers?: HeadersMap;
+    /** Query parameters to append to the URL */
+    query?: Record<string, string | number | boolean | null | undefined>;
+    /** Request body (will be JSON-serialized) */
+    body?: unknown;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+    /** Retry configuration for this request */
+    retry?: RetryOptions;
+}
+/**
+ * Configuration options for creating a NocoClient instance.
+ */
+interface ClientOptions {
+    /** Base URL of the NocoDB instance (e.g., 'https://app.nocodb.com') */
+    baseUrl: string;
+    /** Default headers to include in all requests (e.g., authentication token) */
+    headers?: HeadersMap;
+    /** Default timeout in milliseconds for all requests */
+    timeoutMs?: number;
+    /** Default retry configuration for all requests */
+    retry?: RetryOptions;
+}
+/**
+ * HTTP client for making requests to NocoDB APIs.
+ *
+ * Provides low-level HTTP request functionality with automatic error mapping,
+ * retry logic, and timeout handling. Most users should use MetaApi or DataApi
+ * instead of calling this directly.
+ *
+ * @example
+ * ```typescript
+ * const client = new NocoClient({
+ *   baseUrl: 'https://app.nocodb.com',
+ *   headers: { 'xc-token': 'your-api-token' },
+ *   timeoutMs: 30000,
+ *   retry: {
+ *     retry: 3,
+ *     retryDelay: 1000,
+ *     retryStatusCodes: [408, 429, 500, 502, 503, 504]
+ *   }
+ * });
+ * ```
+ */
+declare class NocoClient {
+    private baseUrl;
+    private headers;
+    private timeoutMs?;
+    private retryOptions?;
+    /**
+     * Creates a new NocoClient instance.
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options: ClientOptions);
+    /**
+     * Sets a default header that will be included in all requests.
+     *
+     * @param name - Header name
+     * @param value - Header value
+     *
+     * @example
+     * ```typescript
+     * client.setHeader('xc-token', 'new-api-token');
+     * ```
+     */
+    setHeader(name: string, value: string): void;
+    /**
+     * Removes a default header.
+     *
+     * @param name - Header name to remove
+     *
+     * @example
+     * ```typescript
+     * client.removeHeader('xc-token');
+     * ```
+     */
+    removeHeader(name: string): void;
+    /**
+     * Makes an HTTP request to the NocoDB API.
+     *
+     * Automatically handles error mapping, retry logic, and timeout handling.
+     * Throws typed errors (AuthenticationError, NotFoundError, etc.) based on
+     * HTTP status codes.
+     *
+     * @template T - Expected response type
+     * @param method - HTTP method (GET, POST, PATCH, DELETE, etc.)
+     * @param path - API endpoint path (e.g., '/api/v2/meta/bases')
+     * @param options - Request options (headers, query params, body, etc.)
+     * @returns Promise resolving to the typed response
+     * @throws {AuthenticationError} When authentication fails (401, 403)
+     * @throws {NotFoundError} When resource is not found (404)
+     * @throws {ConflictError} When a conflict occurs (409)
+     * @throws {ValidationError} When request validation fails (400)
+     * @throws {NetworkError} For network-level errors or other HTTP errors
+     *
+     * @example
+     * ```typescript
+     * const bases = await client.request<ListResponse<Base>>(
+     *   'GET',
+     *   '/api/v2/meta/bases'
+     * );
+     *
+     * const newBase = await client.request<Base>(
+     *   'POST',
+     *   '/api/v2/meta/bases',
+     *   { body: { title: 'My Base' } }
+     * );
+     * ```
+     */
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Fetches all pages of a paginated list endpoint and returns the combined results.
+     *
+     * Automatically handles offset-based pagination by making sequential requests
+     * until all rows are retrieved. Useful for large datasets where a single request
+     * would only return a partial result.
+     *
+     * @template T - The type of items in the list
+     * @param method - HTTP method (typically 'GET')
+     * @param path - API endpoint path
+     * @param options - Request options (query params, headers, etc.)
+     * @param pageSize - Number of items per page (default: 1000)
+     * @returns Promise resolving to a ListResponse containing all items
+     *
+     * @example
+     * ```typescript
+     * // Fetch all rows from a table
+     * const allRows = await client.fetchAllPages<Row>(
+     *   'GET',
+     *   '/api/v2/tables/tbl123/records'
+     * );
+     * console.log(`Total: ${allRows.list.length} rows`);
+     *
+     * // Fetch all with a filter
+     * const filtered = await client.fetchAllPages<Row>(
+     *   'GET',
+     *   '/api/v2/tables/tbl123/records',
+     *   { query: { where: '(Status,eq,Active)' } }
+     * );
+     * ```
+     */
+    fetchAllPages<T>(method: string, path: string, options?: RequestOptions, pageSize?: number): Promise<ListResponse<T>>;
+}
+/**
+ * Reference to a base by ID and optional title.
+ * Used for identifying bases in API operations.
+ */
+interface BaseRef {
+    /** Unique identifier for the base */
+    id: string;
+    /** Optional display title */
+    title?: string;
+}
+/**
+ * Reference to a table by ID and optional title.
+ * Used for identifying tables in API operations.
+ */
+interface TableRef {
+    /** Unique identifier for the table */
+    id: string;
+    /** Optional display title */
+    title?: string;
+}
+/**
+ * Reference to a view by ID and optional title.
+ * Used for identifying views in API operations.
+ */
+interface ViewRef {
+    /** Unique identifier for the view */
+    id: string;
+    /** Optional display title */
+    title?: string;
+}
+/**
+ * Reference to a filter by ID.
+ * Used for identifying filters in API operations.
+ */
+interface FilterRef {
+    /** Unique identifier for the filter */
+    id: string;
+}
+/**
+ * Reference to a sort by ID.
+ * Used for identifying sorts in API operations.
+ */
+interface SortRef {
+    /** Unique identifier for the sort */
+    id: string;
+}
+/**
+ * Reference to a column by ID.
+ * Used for identifying columns in API operations.
+ */
+interface ColumnRef {
+    /** Unique identifier for the column */
+    id: string;
+}
+/**
+ * API methods for metadata operations (bases, tables, views, columns, filters, sorts).
+ *
+ * Provides typed methods for all CRUD operations on NocoDB metadata entities.
+ * All methods return strongly-typed responses and throw typed errors on failure.
+ *
+ * @example
+ * ```typescript
+ * const client = new NocoClient({ baseUrl: '...', headers: { 'xc-token': '...' } });
+ * const metaApi = new MetaApi(client);
+ *
+ * // List all bases
+ * const bases = await metaApi.listBases();
+ *
+ * // Create a new table
+ * const table = await metaApi.createTable('base_id', {
+ *   title: 'Users',
+ *   table_name: 'users'
+ * });
+ * ```
+ */
+declare class MetaApi {
+    private client;
+    /**
+     * Creates a new MetaApi instance.
+     *
+     * @param client - NocoClient instance for making HTTP requests
+     */
+    constructor(client: NocoClient);
+    /**
+     * Lists all bases accessible to the authenticated user.
+     *
+     * @returns Promise resolving to paginated list of bases
+     * @throws {AuthenticationError} If authentication fails
+     * @throws {NetworkError} If the request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listBases();
+     * console.log(`Found ${response.pageInfo.totalRows} bases`);
+     * ```
+     */
+    listBases(): Promise<ListResponse<Base>>;
+    /**
+     * Creates a new base.
+     *
+     * @param body - Base properties (title is required)
+     * @returns Promise resolving to the created base
+     * @throws {ValidationError} If the request data is invalid
+     * @throws {AuthenticationError} If authentication fails
+     *
+     * @example
+     * ```typescript
+     * const base = await metaApi.createBase({ title: 'My Project' });
+     * console.log(`Created base: ${base.id}`);
+     * ```
+     */
+    createBase(body: Partial<Base>): Promise<Base>;
+    /**
+     * Gets detailed information about a specific base.
+     *
+     * @param baseId - ID of the base to retrieve
+     * @returns Promise resolving to the base details
+     * @throws {NotFoundError} If the base doesn't exist
+     * @throws {AuthenticationError} If authentication fails
+     *
+     * @example
+     * ```typescript
+     * const base = await metaApi.getBase('base_abc123');
+     * console.log(`Base title: ${base.title}`);
+     * ```
+     */
+    getBase(baseId: string): Promise<Base>;
+    /**
+     * Gets base information including metadata.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to the base info
+     * @throws {NotFoundError} If the base doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await metaApi.getBaseInfo('base_abc123');
+     * ```
+     */
+    getBaseInfo(baseId: string): Promise<Base>;
+    /**
+     * Updates a base's properties.
+     *
+     * @param baseId - ID of the base to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated base
+     * @throws {NotFoundError} If the base doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateBase('base_abc123', { title: 'New Title' });
+     * ```
+     */
+    updateBase(baseId: string, body: Partial<Base>): Promise<Base>;
+    /**
+     * Deletes a base permanently.
+     *
+     * @param baseId - ID of the base to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the base doesn't exist
+     * @throws {AuthenticationError} If authentication fails
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteBase('base_abc123');
+     * console.log('Base deleted');
+     * ```
+     */
+    deleteBase(baseId: string): Promise<void>;
+    /**
+     * Lists all data sources for a base.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to paginated list of sources
+     * @throws {NotFoundError} If the base doesn't exist
+     */
+    listSources(baseId: string): Promise<ListResponse<Source>>;
+    /**
+     * Creates a new data source in a base.
+     *
+     * @param baseId - ID of the base
+     * @param body - Source properties (alias, type, config, etc.)
+     * @returns Promise resolving to the created source
+     * @throws {ValidationError} If the request data is invalid
+     */
+    createSource(baseId: string, body: Partial<Source>): Promise<Source>;
+    /**
+     * Gets detailed information about a specific data source.
+     *
+     * @param baseId - ID of the base
+     * @param sourceId - ID of the source to retrieve
+     * @returns Promise resolving to the source details
+     * @throws {NotFoundError} If the source doesn't exist
+     */
+    getSource(baseId: string, sourceId: string): Promise<Source>;
+    /**
+     * Updates a data source's properties.
+     *
+     * @param baseId - ID of the base
+     * @param sourceId - ID of the source to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated source
+     * @throws {NotFoundError} If the source doesn't exist
+     */
+    updateSource(baseId: string, sourceId: string, body: Partial<Source>): Promise<Source>;
+    /**
+     * Deletes a data source permanently.
+     *
+     * @param baseId - ID of the base
+     * @param sourceId - ID of the source to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the source doesn't exist
+     */
+    deleteSource(baseId: string, sourceId: string): Promise<void>;
+    /**
+     * Lists all tables in a base.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to paginated list of tables
+     * @throws {NotFoundError} If the base doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listTables('base_abc123');
+     * for (const table of response.list) {
+     *   console.log(`Table: ${table.title}`);
+     * }
+     * ```
+     */
+    listTables(baseId: string): Promise<ListResponse<Table>>;
+    /**
+     * Creates a new table in a base.
+     *
+     * @param baseId - ID of the base
+     * @param body - Table properties (title and table_name are required)
+     * @returns Promise resolving to the created table
+     * @throws {ValidationError} If the request data is invalid
+     * @throws {ConflictError} If a table with the same name already exists
+     *
+     * @example
+     * ```typescript
+     * const table = await metaApi.createTable('base_abc123', {
+     *   title: 'Users',
+     *   table_name: 'users'
+     * });
+     * ```
+     */
+    createTable(baseId: string, body: Partial<Table>): Promise<Table>;
+    /**
+     * Gets detailed information about a specific table.
+     *
+     * @param tableId - ID of the table to retrieve
+     * @returns Promise resolving to the table details including columns
+     * @throws {NotFoundError} If the table doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const table = await metaApi.getTable('tbl_abc123');
+     * console.log(`Table has ${table.columns?.length} columns`);
+     * ```
+     */
+    getTable(tableId: string): Promise<Table>;
+    /**
+     * Updates a table's properties.
+     *
+     * @param tableId - ID of the table to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated table
+     * @throws {NotFoundError} If the table doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateTable('tbl_abc123', { title: 'New Title' });
+     * ```
+     */
+    updateTable(tableId: string, body: Partial<Table>): Promise<Table>;
+    /**
+     * Deletes a table permanently.
+     *
+     * @param tableId - ID of the table to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the table doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteTable('tbl_abc123');
+     * ```
+     */
+    deleteTable(tableId: string): Promise<void>;
+    /**
+     * Lists all views for a table.
+     *
+     * @param tableId - ID of the table
+     * @returns Promise resolving to paginated list of views
+     * @throws {NotFoundError} If the table doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listViews('tbl_abc123');
+     * for (const view of response.list) {
+     *   console.log(`View: ${view.title} (${view.type})`);
+     * }
+     * ```
+     */
+    listViews(tableId: string): Promise<ListResponse<View>>;
+    /**
+     * Creates a new view for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - View properties (title and type are required)
+     * @returns Promise resolving to the created view
+     * @throws {ValidationError} If the request data is invalid
+     *
+     * @example
+     * ```typescript
+     * const view = await metaApi.createView('tbl_abc123', {
+     *   title: 'Active Users',
+     *   type: 'grid'
+     * });
+     * ```
+     */
+    createView(tableId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Gets detailed information about a specific view.
+     *
+     * @param viewId - ID of the view to retrieve
+     * @returns Promise resolving to the view details
+     * @throws {NotFoundError} If the view doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const view = await metaApi.getView('vw_abc123');
+     * ```
+     */
+    getView(viewId: string): Promise<View>;
+    /**
+     * Updates a view's properties.
+     *
+     * @param viewId - ID of the view to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated view
+     * @throws {NotFoundError} If the view doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateView('vw_abc123', { title: 'New Title' });
+     * ```
+     */
+    updateView(viewId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Deletes a view permanently.
+     *
+     * @param viewId - ID of the view to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the view doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteView('vw_abc123');
+     * ```
+     */
+    deleteView(viewId: string): Promise<void>;
+    /**
+     * Lists all filters for a view.
+     *
+     * @param viewId - ID of the view
+     * @returns Promise resolving to paginated list of filters
+     * @throws {NotFoundError} If the view doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listViewFilters('vw_abc123');
+     * ```
+     */
+    listViewFilters(viewId: string): Promise<ListResponse<Filter>>;
+    /**
+     * Creates a new filter for a view.
+     *
+     * @param viewId - ID of the view
+     * @param body - Filter properties
+     * @returns Promise resolving to the created filter
+     * @throws {ValidationError} If the request data is invalid
+     *
+     * @example
+     * ```typescript
+     * const filter = await metaApi.createViewFilter('vw_abc123', {
+     *   fk_column_id: 'col_xyz',
+     *   comparison_op: 'eq',
+     *   value: 'active'
+     * });
+     * ```
+     */
+    createViewFilter(viewId: string, body: Partial<Filter>): Promise<Filter>;
+    /**
+     * Gets detailed information about a specific filter.
+     *
+     * @param filterId - ID of the filter to retrieve
+     * @returns Promise resolving to the filter details
+     * @throws {NotFoundError} If the filter doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const filter = await metaApi.getFilter('flt_abc123');
+     * ```
+     */
+    getFilter(filterId: string): Promise<Filter>;
+    /**
+     * Updates a filter's properties.
+     *
+     * @param filterId - ID of the filter to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated filter
+     * @throws {NotFoundError} If the filter doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateFilter('flt_abc123', { value: 'inactive' });
+     * ```
+     */
+    updateFilter(filterId: string, body: Partial<Filter>): Promise<Filter>;
+    /**
+     * Deletes a filter permanently.
+     *
+     * @param filterId - ID of the filter to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the filter doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteFilter('flt_abc123');
+     * ```
+     */
+    deleteFilter(filterId: string): Promise<void>;
+    /**
+     * Lists all sorts for a view.
+     *
+     * @param viewId - ID of the view
+     * @returns Promise resolving to paginated list of sorts
+     * @throws {NotFoundError} If the view doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listViewSorts('vw_abc123');
+     * ```
+     */
+    listViewSorts(viewId: string): Promise<ListResponse<Sort>>;
+    /**
+     * Creates a new sort for a view.
+     *
+     * @param viewId - ID of the view
+     * @param body - Sort properties (fk_column_id and direction are required)
+     * @returns Promise resolving to the created sort
+     * @throws {ValidationError} If the request data is invalid
+     *
+     * @example
+     * ```typescript
+     * const sort = await metaApi.createViewSort('vw_abc123', {
+     *   fk_column_id: 'col_xyz',
+     *   direction: 'asc'
+     * });
+     * ```
+     */
+    createViewSort(viewId: string, body: Partial<Sort>): Promise<Sort>;
+    /**
+     * Gets detailed information about a specific sort.
+     *
+     * @param sortId - ID of the sort to retrieve
+     * @returns Promise resolving to the sort details
+     * @throws {NotFoundError} If the sort doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const sort = await metaApi.getSort('srt_abc123');
+     * ```
+     */
+    getSort(sortId: string): Promise<Sort>;
+    /**
+     * Updates a sort's properties.
+     *
+     * @param sortId - ID of the sort to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated sort
+     * @throws {NotFoundError} If the sort doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateSort('srt_abc123', { direction: 'desc' });
+     * ```
+     */
+    updateSort(sortId: string, body: Partial<Sort>): Promise<Sort>;
+    /**
+     * Deletes a sort permanently.
+     *
+     * @param sortId - ID of the sort to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the sort doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteSort('srt_abc123');
+     * ```
+     */
+    deleteSort(sortId: string): Promise<void>;
+    /**
+     * Lists all columns for a table.
+     *
+     * @param tableId - ID of the table
+     * @returns Promise resolving to paginated list of columns
+     * @throws {NotFoundError} If the table doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const response = await metaApi.listColumns('tbl_abc123');
+     * for (const col of response.list) {
+     *   console.log(`Column: ${col.title} (${col.uidt})`);
+     * }
+     * ```
+     */
+    listColumns(tableId: string): Promise<ListResponse<Column>>;
+    /**
+     * Creates a new column in a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - Column properties (title, column_name, and uidt are required)
+     * @returns Promise resolving to the created column
+     * @throws {ValidationError} If the request data is invalid
+     * @throws {ConflictError} If a column with the same name already exists
+     *
+     * @example
+     * ```typescript
+     * const column = await metaApi.createColumn('tbl_abc123', {
+     *   title: 'Email',
+     *   column_name: 'email',
+     *   uidt: 'Email'
+     * });
+     * ```
+     */
+    createColumn(tableId: string, body: Partial<Column>): Promise<Column>;
+    /**
+     * Gets detailed information about a specific column.
+     *
+     * @param columnId - ID of the column to retrieve
+     * @returns Promise resolving to the column details
+     * @throws {NotFoundError} If the column doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const column = await metaApi.getColumn('col_abc123');
+     * ```
+     */
+    getColumn(columnId: string): Promise<Column>;
+    /**
+     * Updates a column's properties.
+     *
+     * @param columnId - ID of the column to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated column
+     * @throws {NotFoundError} If the column doesn't exist
+     * @throws {ValidationError} If the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * const updated = await metaApi.updateColumn('col_abc123', { title: 'New Title' });
+     * ```
+     */
+    updateColumn(columnId: string, body: Partial<Column>): Promise<Column>;
+    /**
+     * Deletes a column permanently.
+     *
+     * @param columnId - ID of the column to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the column doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await metaApi.deleteColumn('col_abc123');
+     * ```
+     */
+    deleteColumn(columnId: string): Promise<void>;
+    /**
+     * Lists all hooks for a table.
+     *
+     * @param tableId - ID of the table
+     * @returns Promise resolving to paginated list of hooks
+     * @throws {NotFoundError} If the table doesn't exist
+     */
+    listHooks(tableId: string): Promise<ListResponse<Hook>>;
+    /**
+     * Creates a new hook (webhook) for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - Hook properties
+     * @returns Promise resolving to the created hook
+     * @throws {ValidationError} If the request data is invalid
+     */
+    createHook(tableId: string, body: Partial<Hook>): Promise<Hook>;
+    /**
+     * Gets detailed information about a specific hook.
+     *
+     * @param hookId - ID of the hook to retrieve
+     * @returns Promise resolving to the hook details
+     * @throws {NotFoundError} If the hook doesn't exist
+     */
+    getHook(hookId: string): Promise<Hook>;
+    /**
+     * Updates a hook's properties.
+     *
+     * @param hookId - ID of the hook to update
+     * @param body - Properties to update
+     * @returns Promise resolving to the updated hook
+     * @throws {NotFoundError} If the hook doesn't exist
+     */
+    updateHook(hookId: string, body: Partial<Hook>): Promise<Hook>;
+    /**
+     * Deletes a hook permanently.
+     *
+     * @param hookId - ID of the hook to delete
+     * @returns Promise that resolves when deletion is complete
+     * @throws {NotFoundError} If the hook doesn't exist
+     */
+    deleteHook(hookId: string): Promise<void>;
+    /**
+     * Tests a hook by triggering a sample notification.
+     *
+     * @param hookId - ID of the hook to test
+     * @param body - Optional test payload
+     * @returns Promise resolving to the test result
+     * @throws {NotFoundError} If the hook doesn't exist
+     */
+    testHook(hookId: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Lists all API tokens for a base.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to a list of API tokens
+     */
+    listTokens(baseId: string): Promise<ListResponse<ApiToken>>;
+    /**
+     * Creates a new API token for a base.
+     *
+     * @param baseId - ID of the base
+     * @param body - Token properties (description is recommended)
+     * @returns Promise resolving to the created token (includes the token string)
+     */
+    createToken(baseId: string, body: Partial<ApiToken>): Promise<ApiToken>;
+    /**
+     * Deletes an API token from a base.
+     *
+     * @param baseId - ID of the base
+     * @param tokenId - ID of the token to delete
+     * @returns Promise that resolves when deletion is complete
+     */
+    deleteToken(baseId: string, tokenId: string): Promise<void>;
+    /**
+     * Lists all users (collaborators) for a base.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to a list of base users
+     * @throws {NotFoundError} If the base doesn't exist
+     */
+    listBaseUsers(baseId: string): Promise<ListResponse<BaseUser>>;
+    /**
+     * Invites a user to a base.
+     *
+     * @param baseId - ID of the base
+     * @param body - User properties (email and roles are required)
+     * @returns Promise resolving to the invite result
+     * @throws {ValidationError} If the request data is invalid
+     */
+    inviteBaseUser(baseId: string, body: Partial<BaseUser>): Promise<unknown>;
+    /**
+     * Updates a user's role in a base.
+     *
+     * @param baseId - ID of the base
+     * @param userId - ID of the user to update
+     * @param body - Properties to update (typically roles)
+     * @returns Promise resolving to the updated user
+     */
+    updateBaseUser(baseId: string, userId: string, body: Partial<BaseUser>): Promise<unknown>;
+    /**
+     * Removes a user from a base.
+     *
+     * @param baseId - ID of the base
+     * @param userId - ID of the user to remove
+     * @returns Promise that resolves when removal is complete
+     */
+    removeBaseUser(baseId: string, userId: string): Promise<void>;
+    /**
+     * Lists comments for a specific row.
+     *
+     * @param tableId - ID of the table (fk_model_id)
+     * @param rowId - ID of the row
+     * @returns Promise resolving to a list of comments
+     */
+    listComments(tableId: string, rowId: string): Promise<ListResponse<Comment>>;
+    /**
+     * Creates a comment on a row.
+     *
+     * @param body - Comment properties (fk_model_id, row_id, comment are required)
+     * @returns Promise resolving to the created comment
+     */
+    createComment(body: Partial<Comment>): Promise<Comment>;
+    /**
+     * Updates a comment.
+     *
+     * @param commentId - ID of the comment to update
+     * @param body - Properties to update (typically comment text)
+     * @returns Promise resolving to the updated comment
+     */
+    updateComment(commentId: string, body: Partial<Comment>): Promise<Comment>;
+    /**
+     * Deletes a comment.
+     *
+     * @param commentId - ID of the comment to delete
+     * @returns Promise that resolves when deletion is complete
+     */
+    deleteComment(commentId: string): Promise<void>;
+    /**
+     * Lists shared views for a table.
+     *
+     * @param tableId - ID of the table
+     * @returns Promise resolving to a list of shared views
+     */
+    listSharedViews(tableId: string): Promise<ListResponse<SharedView>>;
+    /**
+     * Creates a shared view (public link) for a view.
+     *
+     * @param viewId - ID of the view to share
+     * @param body - Optional shared view properties (password, meta)
+     * @returns Promise resolving to the created shared view
+     */
+    createSharedView(viewId: string, body?: Partial<SharedView>): Promise<SharedView>;
+    /**
+     * Updates a shared view's properties.
+     *
+     * @param viewId - ID of the view whose share to update
+     * @param body - Properties to update (password, meta)
+     * @returns Promise resolving to the updated shared view
+     */
+    updateSharedView(viewId: string, body: Partial<SharedView>): Promise<SharedView>;
+    /**
+     * Deletes a shared view (removes public link).
+     *
+     * @param viewId - ID of the view whose share to delete
+     * @returns Promise that resolves when deletion is complete
+     */
+    deleteSharedView(viewId: string): Promise<void>;
+    /**
+     * Gets shared base info (uuid, url, roles).
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to the shared base info
+     */
+    getSharedBase(baseId: string): Promise<SharedBase>;
+    /**
+     * Creates a shared base (enables public sharing).
+     *
+     * @param baseId - ID of the base
+     * @param body - Shared base properties (roles, password)
+     * @returns Promise resolving to the created shared base
+     */
+    createSharedBase(baseId: string, body?: Partial<SharedBase>): Promise<SharedBase>;
+    /**
+     * Updates a shared base's properties.
+     *
+     * @param baseId - ID of the base
+     * @param body - Properties to update (roles, password)
+     * @returns Promise resolving to the updated shared base
+     */
+    updateSharedBase(baseId: string, body: Partial<SharedBase>): Promise<SharedBase>;
+    /**
+     * Disables shared base (removes public sharing).
+     *
+     * @param baseId - ID of the base
+     * @returns Promise that resolves when sharing is disabled
+     */
+    deleteSharedBase(baseId: string): Promise<void>;
+    /**
+     * Creates a grid view for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - View properties (title is required)
+     * @returns Promise resolving to the created view
+     */
+    createGridView(tableId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Creates a form view for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - View properties (title is required)
+     * @returns Promise resolving to the created view
+     */
+    createFormView(tableId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Creates a gallery view for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - View properties (title is required)
+     * @returns Promise resolving to the created view
+     */
+    createGalleryView(tableId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Creates a kanban view for a table.
+     *
+     * @param tableId - ID of the table
+     * @param body - View properties (title is required)
+     * @returns Promise resolving to the created view
+     */
+    createKanbanView(tableId: string, body: Partial<View>): Promise<View>;
+    /**
+     * Gets form view-specific configuration.
+     *
+     * @param formViewId - ID of the form view
+     * @returns Promise resolving to the form view config
+     */
+    getFormView(formViewId: string): Promise<FormView>;
+    /**
+     * Updates form view-specific configuration.
+     *
+     * @param formViewId - ID of the form view
+     * @param body - Form-specific properties to update
+     * @returns Promise resolving to the updated form view config
+     */
+    updateFormView(formViewId: string, body: Partial<FormView>): Promise<FormView>;
+    /**
+     * Gets gallery view-specific configuration.
+     *
+     * @param galleryViewId - ID of the gallery view
+     * @returns Promise resolving to the gallery view config
+     */
+    getGalleryView(galleryViewId: string): Promise<GalleryView>;
+    /**
+     * Updates gallery view-specific configuration.
+     *
+     * @param galleryViewId - ID of the gallery view
+     * @param body - Gallery-specific properties to update
+     * @returns Promise resolving to the updated gallery view config
+     */
+    updateGalleryView(galleryViewId: string, body: Partial<GalleryView>): Promise<GalleryView>;
+    /**
+     * Gets kanban view-specific configuration.
+     *
+     * @param kanbanViewId - ID of the kanban view
+     * @returns Promise resolving to the kanban view config
+     */
+    getKanbanView(kanbanViewId: string): Promise<KanbanView>;
+    /**
+     * Updates kanban view-specific configuration.
+     *
+     * @param kanbanViewId - ID of the kanban view
+     * @param body - Kanban-specific properties to update
+     * @returns Promise resolving to the updated kanban view config
+     */
+    updateKanbanView(kanbanViewId: string, body: Partial<KanbanView>): Promise<KanbanView>;
+    /**
+     * Updates grid view-specific configuration.
+     *
+     * @param gridViewId - ID of the grid view
+     * @param body - Grid-specific properties to update
+     * @returns Promise resolving to the updated grid view config
+     */
+    updateGridView(gridViewId: string, body: Partial<GridView>): Promise<GridView>;
+    /**
+     * Lists columns for a view (field visibility/order settings).
+     *
+     * @param viewId - ID of the view
+     * @returns Promise resolving to a list of view columns
+     */
+    listViewColumns(viewId: string): Promise<ListResponse<ViewColumn>>;
+    /**
+     * Lists child filters of a filter group.
+     *
+     * @param filterGroupId - ID of the parent filter group
+     * @returns Promise resolving to a list of child filters
+     */
+    listFilterChildren(filterGroupId: string): Promise<ListResponse<Filter>>;
+    /**
+     * Lists filters for a hook (webhook).
+     *
+     * @param hookId - ID of the hook
+     * @returns Promise resolving to a list of hook filters
+     */
+    listHookFilters(hookId: string): Promise<ListResponse<Filter>>;
+    /**
+     * Creates a filter for a hook (webhook).
+     *
+     * @param hookId - ID of the hook
+     * @param body - Filter properties
+     * @returns Promise resolving to the created filter
+     */
+    createHookFilter(hookId: string, body: Partial<Filter>): Promise<Filter>;
+    /**
+     * Sets a column as the primary/display column for its table.
+     *
+     * @param columnId - ID of the column to set as primary
+     * @returns Promise resolving when the column is set as primary
+     */
+    setColumnPrimary(columnId: string): Promise<unknown>;
+    /**
+     * Duplicates a base.
+     *
+     * @param baseId - ID of the base to duplicate
+     * @param options - Optional duplicate options (excludeData, excludeViews, excludeHooks)
+     * @returns Promise resolving to the duplicate operation result
+     */
+    duplicateBase(baseId: string, options?: DuplicateOptions): Promise<unknown>;
+    /**
+     * Duplicates a base source.
+     *
+     * @param baseId - ID of the base
+     * @param sourceId - ID of the source to duplicate
+     * @param options - Optional duplicate options
+     * @returns Promise resolving to the duplicate operation result
+     */
+    duplicateSource(baseId: string, sourceId: string, options?: DuplicateOptions): Promise<unknown>;
+    /**
+     * Duplicates a table within a base.
+     *
+     * @param baseId - ID of the base
+     * @param tableId - ID of the table to duplicate
+     * @param options - Optional duplicate options
+     * @returns Promise resolving to the duplicate operation result
+     */
+    duplicateTable(baseId: string, tableId: string, options?: DuplicateOptions): Promise<unknown>;
+    /**
+     * Gets view visibility rules for a base (UI ACL).
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to the visibility rules
+     */
+    getVisibilityRules(baseId: string): Promise<VisibilityRule[]>;
+    /**
+     * Sets view visibility rules for a base (UI ACL).
+     *
+     * @param baseId - ID of the base
+     * @param body - Visibility rules to set
+     * @returns Promise resolving when rules are set
+     */
+    setVisibilityRules(baseId: string, body: VisibilityRule[]): Promise<unknown>;
+    /**
+     * Gets NocoDB server application info (version, etc.).
+     *
+     * @returns Promise resolving to the app info
+     */
+    getAppInfo(): Promise<AppInfo>;
+    /**
+     * Lists all workspaces (☁ cloud-only).
+     *
+     * @returns Promise resolving to paginated list of workspaces
+     * @throws {NetworkError} If the instance doesn't support workspaces (self-hosted)
+     */
+    listWorkspaces(): Promise<ListResponse<NcWorkspace>>;
+    /**
+     * Gets a workspace by ID (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @returns Promise resolving to the workspace details and user count
+     * @throws {NotFoundError} If the workspace doesn't exist
+     */
+    getWorkspace(workspaceId: string): Promise<{
+        workspace: NcWorkspace;
+        workspaceUserCount: number;
+    }>;
+    /**
+     * Creates a new workspace (☁ cloud-only).
+     *
+     * @param body - Workspace properties (title is required)
+     * @returns Promise resolving to the created workspace
+     * @throws {ValidationError} If the request data is invalid
+     */
+    createWorkspace(body: Partial<NcWorkspace>): Promise<NcWorkspace>;
+    /**
+     * Updates a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace to update
+     * @param body - Properties to update
+     * @returns Promise resolving when the update is complete
+     */
+    updateWorkspace(workspaceId: string, body: Partial<NcWorkspace>): Promise<void>;
+    /**
+     * Deletes a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace to delete
+     * @returns Promise resolving when deletion is complete
+     */
+    deleteWorkspace(workspaceId: string): Promise<void>;
+    /**
+     * Lists users in a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @returns Promise resolving to a list of workspace users
+     */
+    listWorkspaceUsers(workspaceId: string): Promise<ListResponse<NcWorkspaceUser>>;
+    /**
+     * Gets a specific user in a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @param userId - ID of the user
+     * @returns Promise resolving to the workspace user details
+     */
+    getWorkspaceUser(workspaceId: string, userId: string): Promise<NcWorkspaceUser>;
+    /**
+     * Invites a user to a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @param body - Invite properties (email and roles are required)
+     * @returns Promise resolving to the invite result
+     */
+    inviteWorkspaceUser(workspaceId: string, body: Partial<NcWorkspaceUser>): Promise<unknown>;
+    /**
+     * Updates a user's role in a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @param userId - ID of the user to update
+     * @param body - Properties to update (typically roles)
+     * @returns Promise resolving when the update is complete
+     */
+    updateWorkspaceUser(workspaceId: string, userId: string, body: Partial<NcWorkspaceUser>): Promise<void>;
+    /**
+     * Removes a user from a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @param userId - ID of the user to remove
+     * @returns Promise resolving when removal is complete
+     */
+    deleteWorkspaceUser(workspaceId: string, userId: string): Promise<void>;
+    /**
+     * Lists bases in a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @returns Promise resolving to a paginated list of bases
+     */
+    listWorkspaceBases(workspaceId: string): Promise<ListResponse<Base>>;
+    /**
+     * Creates a base in a workspace (☁ cloud-only).
+     *
+     * @param workspaceId - ID of the workspace
+     * @param body - Base properties (title is required)
+     * @returns Promise resolving to the created base
+     */
+    createWorkspaceBase(workspaceId: string, body: Partial<Base>): Promise<Base>;
+    /**
+     * Gets the Swagger/OpenAPI specification for a base.
+     *
+     * Returns the complete API documentation for all tables and operations
+     * in the specified base.
+     *
+     * @param baseId - ID of the base
+     * @returns Promise resolving to the Swagger document
+     * @throws {NotFoundError} If the base doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const swagger = await metaApi.getBaseSwagger('base_abc123');
+     * console.log(`API version: ${swagger.info.version}`);
+     * ```
+     */
+    getBaseSwagger(baseId: string): Promise<unknown>;
+    /**
+     * Uploads a file attachment.
+     *
+     * Uploads a file from the local filesystem to NocoDB storage.
+     * The returned data can be used in attachment column fields.
+     *
+     * @param filePath - Path to the file to upload
+     * @returns Promise resolving to upload response with file metadata
+     * @throws {ValidationError} If the file doesn't exist or is invalid
+     * @throws {NetworkError} If the upload fails
+     *
+     * @example
+     * ```typescript
+     * const result = await metaApi.uploadAttachment('/path/to/image.png');
+     * // Use result in an attachment column
+     * ```
+     */
+    uploadAttachment(filePath: string): Promise<unknown>;
+}
+/**
+ * API methods for data operations (links between records).
+ *
+ * Provides methods for managing relationships between records in linked tables.
+ */
+declare class DataApi {
+    private client;
+    constructor(client: NocoClient);
+    /**
+     * List linked records for a specific record and link field.
+     *
+     * @param tableId - ID of the table containing the record
+     * @param linkFieldId - ID of the link field (column)
+     * @param recordId - ID of the record to get links for
+     * @param query - Optional query parameters for filtering/pagination
+     * @returns Paginated list of linked rows
+     *
+     * @example
+     * ```typescript
+     * const links = await dataApi.listLinks('tbl123', 'col456', 'rec789');
+     * console.log(`Found ${links.pageInfo.totalRows} linked records`);
+     * ```
+     */
+    listLinks(tableId: string, linkFieldId: string, recordId: string, query?: Record<string, any>): Promise<ListResponse<Row>>;
+    /**
+     * Link records together via a link field.
+     *
+     * @param tableId - ID of the table containing the record
+     * @param linkFieldId - ID of the link field (column)
+     * @param recordId - ID of the record to link from
+     * @param body - Array of record IDs or objects to link
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await dataApi.linkRecords('tbl123', 'col456', 'rec789', [{ Id: 'rec999' }]);
+     * ```
+     */
+    linkRecords(tableId: string, linkFieldId: string, recordId: string, body: unknown): Promise<unknown>;
+    /**
+     * Unlink records from a link field.
+     *
+     * @param tableId - ID of the table containing the record
+     * @param linkFieldId - ID of the link field (column)
+     * @param recordId - ID of the record to unlink from
+     * @param body - Array of record IDs or objects to unlink
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await dataApi.unlinkRecords('tbl123', 'col456', 'rec789', [{ Id: 'rec999' }]);
+     * ```
+     */
+    unlinkRecords(tableId: string, linkFieldId: string, recordId: string, body: unknown): Promise<unknown>;
+}
+/**
+ * Normalizes a base URL by removing trailing slashes.
+ *
+ * @param input - Base URL to normalize
+ * @returns Normalized URL without trailing slashes
+ *
+ * @example
+ * ```typescript
+ * normalizeBaseUrl('https://app.nocodb.com/') // 'https://app.nocodb.com'
+ * normalizeBaseUrl('https://app.nocodb.com') // 'https://app.nocodb.com'
+ * ```
+ */
+declare function normalizeBaseUrl(input: string): string;
+/**
+ * Parses a header string in 'Name: Value' format.
+ *
+ * @param input - Header string to parse
+ * @returns Tuple of [name, value]
+ * @throws {Error} If the header format is invalid
+ *
+ * @example
+ * ```typescript
+ * const [name, value] = parseHeader('xc-token: my-api-token');
+ * // name = 'xc-token', value = 'my-api-token'
+ * ```
+ */
+declare function parseHeader(input: string): [string, string];
+
+export { type ApiToken, type AppInfo, AuthenticationError, type Base, type BaseRef, type BaseUser, type BulkCreateResponse, type BulkCreateResponseWithErrors, type BulkDeleteResponse, type BulkDeleteResponseWithErrors, type BulkOperationError, type BulkUpdateResponse, type BulkUpdateResponseWithErrors, type ClientOptions, type Column, type ColumnRef, type ColumnType, type Comment, type ComparisonOperator, ConflictError, DataApi, type DuplicateOptions, type ErrorResponse, type Filter, type FilterRef, type FormView, type GalleryView, type GridView, type HeadersMap, type Hook, type KanbanView, type ListResponse, MetaApi, type NcWorkspace, type NcWorkspaceUser, NetworkError, NocoClient, NocoDBError, NotFoundError, type PageInfo, type RequestOptions, type RetryOptions, type Row, type SharedBase, type SharedView, type Sort, type SortRef, type Source, type SourceType, type Table, type TableRef, ValidationError, type View, type ViewColumn, type ViewRef, type ViewType, type VisibilityRule, normalizeBaseUrl, parseHeader };