geodedo 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1157 @@
+/**
+ * Options that can be passed per-request to override client defaults.
+ */
+interface RequestOptions {
+    /** Override the API key for this request. */
+    apiKey?: string;
+    /** Override the user ID for this request. */
+    userId?: string;
+    /** Override the request timeout in milliseconds. */
+    timeout?: number;
+    /** Additional headers to merge into the request. */
+    headers?: Record<string, string>;
+    /** An AbortSignal to cancel the request. */
+    signal?: AbortSignal;
+}
+/**
+ * Options for constructing a GeoDedo client.
+ */
+interface ClientOptions {
+    /** API key for authentication (e.g. "gd_live_xxx"). */
+    apiKey: string;
+    /** Default user ID sent via X-User-Id header for user-scoped operations. */
+    userId?: string;
+    /** Base URL for the API. Defaults to "https://geodedo-api.vercel.app". */
+    baseURL?: string;
+    /** Maximum number of retries for failed requests. Defaults to 2. */
+    maxRetries?: number;
+    /** Default request timeout in milliseconds. Defaults to 60000. */
+    timeout?: number;
+    /**
+     * By default, the SDK will throw if it detects it is running in a browser
+     * environment to prevent leaking API keys. Set this to `true` to suppress
+     * that check (use at your own risk).
+     */
+    dangerouslyAllowBrowser?: boolean;
+}
+/**
+ * Pagination parameters for list endpoints.
+ * The API uses page-based pagination (NOT limit/offset).
+ */
+interface PaginationParams {
+    /** Page number (1-indexed). Defaults to 1. */
+    page?: number;
+    /** Number of items per page. Defaults vary by resource. */
+    perPage?: number;
+}
+/**
+ * Generic paginated response from the API.
+ *
+ * The server wraps the data array under a resource-specific key
+ * (e.g. "contacts", "sequences", "drafts"), so callers use
+ * `PageResponse<Contact>` and access the `data` field which is
+ * normalized from whatever wrapper key the server used.
+ */
+interface PageResponse<T> {
+    /** The items on this page (normalized from the server's resource key). */
+    data: T[];
+    /** Total number of items across all pages. */
+    total: number;
+    /** Current page number. */
+    page: number;
+}
+
+/** HTTP methods supported by the client. */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+interface APIClientOptions {
+    apiKey: string;
+    userId?: string;
+    baseURL?: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+/**
+ * Low-level HTTP client that handles auth, retries, timeouts, and error mapping.
+ * Uses the built-in `fetch` API (available in Node 18+).
+ */
+declare class APIClient {
+    readonly apiKey: string;
+    readonly userId: string | undefined;
+    readonly baseURL: string;
+    readonly maxRetries: number;
+    readonly timeout: number;
+    constructor(options: APIClientOptions);
+    /**
+     * Core request method. All convenience methods delegate here.
+     */
+    request<T>(method: HttpMethod, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** Calculate retry delay with exponential backoff and jitter. */
+    private retryDelay;
+    private sleep;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+
+/**
+ * Options needed to fetch the next page of a paginated result.
+ */
+interface PageRequestOptions {
+    /** The API client to use for fetching. */
+    client: APIClient;
+    /** HTTP method (GET or POST). */
+    method: 'GET' | 'POST';
+    /** API path. */
+    path: string;
+    /** Request body (for POST-based pagination like contact search). */
+    body?: Record<string, unknown>;
+    /** Query parameters appended to the URL. */
+    query?: Record<string, string | number>;
+    /** The key in the response that contains the array of items. */
+    responseKey: string;
+    /** Per-request options (auth overrides, etc.). */
+    options?: RequestOptions;
+}
+/**
+ * A single page of results from a paginated API endpoint.
+ *
+ * Supports:
+ * - `data` / `total` / `page` accessors
+ * - `hasNextPage()` / `getNextPage()` for manual iteration
+ * - `Symbol.asyncIterator` for `for await...of` across all pages
+ */
+declare class Page<T> {
+    /** The items on this page. */
+    readonly data: T[];
+    /** Total number of items across all pages. */
+    readonly total: number;
+    /** Current page number (1-indexed). */
+    readonly page: number;
+    /** Number of items per page (inferred from the current page size). */
+    readonly perPage: number;
+    private readonly _requestOptions;
+    constructor(data: T[], total: number, page: number, perPage: number, requestOptions: PageRequestOptions);
+    /**
+     * Whether there is a next page available.
+     */
+    hasNextPage(): boolean;
+    /**
+     * Fetch the next page. Throws if there is no next page.
+     */
+    getNextPage(): Promise<Page<T>>;
+    /**
+     * Async iterator that yields every item across all pages,
+     * automatically fetching subsequent pages as needed.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+
+/**
+ * Parameters for searching contacts (Apollo-style enrichment).
+ */
+interface ContactSearchParams extends PaginationParams {
+    titles?: string[];
+    seniorities?: string[];
+    locations?: string[];
+    employeeRanges?: string[];
+    departments?: string[];
+    source?: string;
+}
+/**
+ * Parameters for enriching a single contact.
+ */
+interface ContactEnrichParams {
+    email?: string;
+    linkedinUrl?: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+}
+/**
+ * A single contact entry within an import batch.
+ */
+interface ContactImportEntry {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    title?: string;
+    company?: string;
+}
+/**
+ * Parameters for importing contacts from a CSV-like batch.
+ */
+interface ContactImportParams {
+    name?: string;
+    contacts: ContactImportEntry[];
+}
+/**
+ * An enriched contact returned from search or enrich.
+ */
+interface Contact {
+    firstName: string;
+    lastName: string;
+    fullName: string;
+    email: string;
+    phone: string;
+    title: string;
+    company: string;
+    linkedinUrl: string;
+    location: string;
+}
+/**
+ * A stored contact in the user's account.
+ */
+interface StoredContact {
+    id: string;
+    tenant_user_id: string;
+    email: string;
+    provider: string;
+    status: string;
+    created_at: string;
+}
+/**
+ * Result of a contact import operation.
+ */
+interface ImportResult {
+    id: string;
+    tenant_user_id: string;
+    name: string;
+    contacts: ContactImportEntry[];
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * A CSV list reference.
+ */
+interface CsvList {
+    id: string;
+    name: string;
+    created_at: string;
+}
+
+/**
+ * Resource for contact search, enrichment, import, and listing.
+ */
+declare class Contacts {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Search for contacts matching the given ICP criteria.
+     * Returns a paginated list of enriched contacts.
+     */
+    search(params: ContactSearchParams, options?: RequestOptions): Promise<Page<Contact>>;
+    /**
+     * Enrich a single contact by email, LinkedIn URL, or name+company.
+     */
+    enrich(params: ContactEnrichParams, options?: RequestOptions): Promise<Contact>;
+    /**
+     * Import a batch of contacts (CSV-like).
+     */
+    importCsv(params: ContactImportParams, options?: RequestOptions): Promise<ImportResult>;
+    /**
+     * List stored contacts for the current user. Paginated.
+     */
+    list(params?: {
+        page?: number;
+        perPage?: number;
+    }, options?: RequestOptions): Promise<Page<StoredContact>>;
+    /**
+     * List all CSV lists (imports) for the current user.
+     */
+    csvLists(options?: RequestOptions): Promise<CsvList[]>;
+}
+
+/**
+ * Parameters for creating a new outreach sequence.
+ */
+interface SequenceCreateParams {
+    name?: string;
+    icp: string;
+    channelType?: string;
+    channel?: string;
+    contactsPerDay?: number;
+    startHour?: number;
+    endHour?: number;
+    activeDays?: string[];
+    timezone?: string;
+    conversationId?: string;
+}
+/**
+ * A sequence record.
+ */
+interface Sequence {
+    id: string;
+    tenant_user_id: string;
+    conversation_id: string;
+    name: string;
+    icp: string;
+    channel_type: string;
+    contacts_per_day: number;
+    start_hour: number;
+    end_hour: number;
+    active_days: string[];
+    timezone: string;
+    status: string;
+    created_at: string;
+}
+/**
+ * Stats attached to a sequence.
+ */
+interface SequenceStats {
+    sent: number;
+    replied: number;
+    pending?: number;
+}
+/**
+ * A sequence with performance stats.
+ */
+interface SequenceWithStats extends Sequence {
+    stats: SequenceStats;
+}
+
+/**
+ * Resource for managing outreach sequences.
+ */
+declare class Sequences {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Create a new outreach sequence.
+     */
+    create(params: SequenceCreateParams, options?: RequestOptions): Promise<Sequence>;
+    /**
+     * List all sequences for the current user. Paginated.
+     */
+    list(params?: {
+        page?: number;
+        perPage?: number;
+    }, options?: RequestOptions): Promise<Page<SequenceWithStats>>;
+    /**
+     * Get a single sequence by ID.
+     */
+    get(sequenceId: string, options?: RequestOptions): Promise<SequenceWithStats>;
+    /**
+     * Pause a running sequence.
+     */
+    pause(sequenceId: string, options?: RequestOptions): Promise<Sequence>;
+    /**
+     * Resume a paused sequence.
+     */
+    resume(sequenceId: string, options?: RequestOptions): Promise<Sequence>;
+    /**
+     * Stop (terminate) a sequence.
+     */
+    stop(sequenceId: string, options?: RequestOptions): Promise<Sequence>;
+    /**
+     * Get the current status of a sequence.
+     */
+    status(sequenceId: string, options?: RequestOptions): Promise<SequenceWithStats>;
+}
+
+/**
+ * A single contact entry for draft generation.
+ */
+interface DraftContact {
+    name?: string;
+    fullName?: string;
+    title?: string;
+    company?: string;
+    email?: string;
+}
+/**
+ * Parameters for generating outreach drafts.
+ */
+interface DraftGenerateParams {
+    contacts: DraftContact[];
+    channel?: string;
+    context?: string;
+    conversationId?: string;
+}
+/**
+ * Parameters for listing drafts.
+ */
+interface DraftListParams {
+    conversationId?: string;
+    batchId?: string;
+    status?: string;
+}
+/**
+ * Parameters for updating a draft.
+ */
+interface DraftUpdateParams {
+    subject?: string;
+    body?: string;
+}
+/**
+ * Parameters for approving drafts.
+ */
+interface DraftApproveParams {
+    draftIds: string[];
+}
+/**
+ * Parameters for sending drafts.
+ */
+interface DraftSendParams {
+    draftIds: string[];
+}
+/**
+ * A draft message record.
+ */
+interface Draft {
+    id: string;
+    tenant_user_id: string;
+    conversation_id: string;
+    batch_id: string;
+    channel: string;
+    to_email: string;
+    to_name: string;
+    to_linkedin_url: string;
+    to_phone: string;
+    subject: string;
+    body: string;
+    status: string;
+    created_at: string;
+}
+/**
+ * Result of a batch draft generation.
+ */
+interface DraftBatchResult {
+    batchId: string;
+    drafts: Draft[];
+}
+/**
+ * Result of approving drafts.
+ */
+interface DraftApproveResult {
+    approved: number;
+    drafts: Draft[];
+}
+/**
+ * An individual send error.
+ */
+interface DraftSendError {
+    draftId: string;
+    error: string;
+}
+/**
+ * Result of sending drafts.
+ */
+interface DraftSendResult {
+    sent: number;
+    failed: number;
+    errors?: DraftSendError[];
+}
+
+/**
+ * Resource for generating, reviewing, approving, and sending outreach drafts.
+ */
+declare class Drafts {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Generate outreach drafts for a list of contacts.
+     */
+    generate(params: DraftGenerateParams, options?: RequestOptions): Promise<DraftBatchResult>;
+    /**
+     * List drafts, optionally filtered by conversation, batch, or status. Paginated.
+     */
+    list(params?: DraftListParams & {
+        page?: number;
+        perPage?: number;
+    }, options?: RequestOptions): Promise<Page<Draft>>;
+    /**
+     * Update a specific draft's subject and/or body.
+     */
+    update(draftId: string, params: DraftUpdateParams, options?: RequestOptions): Promise<Draft>;
+    /**
+     * Approve drafts by their IDs.
+     */
+    approve(params: DraftApproveParams, options?: RequestOptions): Promise<DraftApproveResult>;
+    /**
+     * Send approved drafts.
+     */
+    send(params: DraftSendParams, options?: RequestOptions): Promise<DraftSendResult>;
+}
+
+/**
+ * Parameters for sending an email.
+ */
+interface EmailSendParams {
+    to: string;
+    subject: string;
+    body: string;
+    provider?: 'gmail' | 'agentmail';
+}
+/**
+ * Parameters for sending a LinkedIn message.
+ */
+interface LinkedInSendParams {
+    chatId?: string;
+    text: string;
+    profileUrl?: string;
+    connectionNote?: string;
+}
+/**
+ * Parameters for sending an Instagram message.
+ */
+interface InstagramSendParams {
+    chatId?: string;
+    attendeeId?: string;
+    text: string;
+}
+/**
+ * Parameters for sending an SMS.
+ */
+interface SmsSendParams {
+    to: string;
+    body: string;
+}
+/**
+ * Result of sending an email.
+ */
+interface EmailResult {
+    sent: boolean;
+    id?: string;
+    from?: string;
+    to?: string;
+    status?: string;
+}
+/**
+ * Result of sending a LinkedIn message.
+ */
+interface LinkedInResult {
+    sent: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Result of sending an Instagram message.
+ */
+interface InstagramResult {
+    sent: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Result of sending an SMS.
+ */
+interface SmsResult {
+    sent: boolean;
+    sid?: string;
+    status?: string;
+    to?: string;
+}
+/**
+ * Supported inbox channel types.
+ */
+type InboxChannel = 'gmail' | 'agentmail' | 'linkedin' | 'instagram' | 'sms';
+
+/**
+ * Resource for sending messages across channels and accessing the unified inbox.
+ */
+declare class Messages {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Send an email via Gmail or AgentMail.
+     */
+    sendEmail(params: EmailSendParams, options?: RequestOptions): Promise<EmailResult>;
+    /**
+     * Send a LinkedIn message or connection request.
+     */
+    sendLinkedIn(params: LinkedInSendParams, options?: RequestOptions): Promise<LinkedInResult>;
+    /**
+     * Send an Instagram DM.
+     */
+    sendInstagram(params: InstagramSendParams, options?: RequestOptions): Promise<InstagramResult>;
+    /**
+     * Send an SMS message.
+     */
+    sendSms(params: SmsSendParams, options?: RequestOptions): Promise<SmsResult>;
+    /**
+     * Get the unified inbox for a specific channel.
+     */
+    inbox(channel: InboxChannel, options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+/**
+ * Parameters for creating a chat message / conversation.
+ */
+interface ChatCreateParams {
+    message: string;
+    conversationId?: string;
+}
+/**
+ * Response from the chat endpoint.
+ */
+interface ChatResponse {
+    conversationId: string;
+    response: string;
+    iterations?: number;
+}
+/**
+ * A conversation summary.
+ */
+interface Conversation {
+    id: string;
+    title: string;
+    created_at: string;
+}
+/**
+ * A single message within a conversation.
+ */
+interface ConversationMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    created_at: string;
+}
+
+/**
+ * Sub-resource for conversation management.
+ */
+declare class ConversationsResource {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * List all conversations.
+     */
+    list(options?: RequestOptions): Promise<Conversation[]>;
+    /**
+     * Get messages for a specific conversation.
+     */
+    get(conversationId: string, options?: RequestOptions): Promise<ConversationMessage[]>;
+    /**
+     * Delete a conversation.
+     */
+    delete(conversationId: string, options?: RequestOptions): Promise<void>;
+}
+/**
+ * Resource for the AI chat assistant and conversation management.
+ */
+declare class Chat {
+    private readonly client;
+    /** Sub-resource for managing conversations. */
+    readonly conversations: ConversationsResource;
+    constructor(client: APIClient);
+    /**
+     * Send a message to the AI assistant.
+     */
+    create(params: ChatCreateParams, options?: RequestOptions): Promise<ChatResponse>;
+}
+
+/**
+ * Supported channel names.
+ */
+type ChannelName = 'gmail' | 'linkedin' | 'instagram' | 'agentmail' | 'sms';
+/**
+ * Status of each connected channel.
+ */
+interface ChannelStatus {
+    gmail: {
+        connected: boolean;
+        email?: string;
+    };
+    linkedin: {
+        connected: boolean;
+        status?: string;
+        email?: string;
+    };
+    instagram: {
+        connected: boolean;
+        status?: string;
+        username?: string;
+    };
+    agentmail: {
+        connected: boolean;
+        email?: string;
+    };
+    sms: {
+        connected: boolean;
+        phoneNumber?: string;
+    };
+}
+/**
+ * Result of initiating Gmail OAuth.
+ */
+interface GmailConnectResult {
+    authUrl: string;
+}
+/**
+ * Parameters for connecting LinkedIn.
+ */
+interface LinkedInConnectParams {
+    email: string;
+    password: string;
+}
+/**
+ * Parameters for connecting Instagram.
+ */
+interface InstagramConnectParams {
+    username: string;
+    password: string;
+}
+/**
+ * Parameters for resolving a 2FA checkpoint.
+ */
+interface CheckpointParams {
+    code: string;
+}
+/**
+ * Generic connection result for LinkedIn/Instagram.
+ */
+interface ConnectionResult {
+    account?: {
+        id: string;
+        status: string;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Parameters for creating an AgentMail address.
+ */
+interface AgentMailCreateParams {
+    username: string;
+}
+/**
+ * Result of creating an AgentMail address.
+ */
+interface AgentMailCreateResult {
+    email: string;
+    inboxId: string;
+}
+/**
+ * Parameters for verifying (initiating) SMS.
+ */
+interface SmsVerifyParams {
+    phoneNumber: string;
+}
+/**
+ * Parameters for confirming SMS with a code.
+ */
+interface SmsConfirmParams {
+    phoneNumber: string;
+    code: string;
+}
+/**
+ * Result of SMS verification steps.
+ */
+interface SmsVerifyResult {
+    status: string;
+    to?: string;
+    valid?: boolean;
+}
+
+/**
+ * Sub-resource for Gmail channel operations.
+ */
+declare class GmailChannel {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Initiate Gmail OAuth flow. Returns an authUrl for the user to visit.
+     */
+    connect(options?: RequestOptions): Promise<GmailConnectResult>;
+}
+/**
+ * Sub-resource for LinkedIn channel operations.
+ */
+declare class LinkedInChannel {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Connect a LinkedIn account with credentials.
+     */
+    connect(params: LinkedInConnectParams, options?: RequestOptions): Promise<ConnectionResult>;
+    /**
+     * Resolve a LinkedIn 2FA checkpoint.
+     */
+    checkpoint(params: CheckpointParams, options?: RequestOptions): Promise<ConnectionResult>;
+}
+/**
+ * Sub-resource for Instagram channel operations.
+ */
+declare class InstagramChannel {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Connect an Instagram account with credentials.
+     */
+    connect(params: InstagramConnectParams, options?: RequestOptions): Promise<ConnectionResult>;
+    /**
+     * Resolve an Instagram 2FA checkpoint.
+     */
+    checkpoint(params: CheckpointParams, options?: RequestOptions): Promise<ConnectionResult>;
+}
+/**
+ * Sub-resource for AgentMail channel operations.
+ */
+declare class AgentMailChannel {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Create a new AgentMail address.
+     */
+    create(params: AgentMailCreateParams, options?: RequestOptions): Promise<AgentMailCreateResult>;
+}
+/**
+ * Sub-resource for SMS channel operations.
+ */
+declare class SmsChannel {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Initiate SMS verification for a phone number.
+     */
+    verify(params: SmsVerifyParams, options?: RequestOptions): Promise<SmsVerifyResult>;
+    /**
+     * Confirm SMS verification with the code.
+     */
+    confirm(params: SmsConfirmParams, options?: RequestOptions): Promise<SmsVerifyResult>;
+}
+/**
+ * Resource for managing channel connections (Gmail, LinkedIn, Instagram, AgentMail, SMS).
+ */
+declare class Channels {
+    private readonly client;
+    /** Gmail channel operations. */
+    readonly gmail: GmailChannel;
+    /** LinkedIn channel operations. */
+    readonly linkedin: LinkedInChannel;
+    /** Instagram channel operations. */
+    readonly instagram: InstagramChannel;
+    /** AgentMail channel operations. */
+    readonly agentmail: AgentMailChannel;
+    /** SMS channel operations. */
+    readonly sms: SmsChannel;
+    constructor(client: APIClient);
+    /**
+     * Get the connection status of all channels.
+     */
+    status(options?: RequestOptions): Promise<ChannelStatus>;
+    /**
+     * Disconnect a specific channel.
+     */
+    disconnect(channel: ChannelName, options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * Parameters for uploading a document.
+ */
+interface DocumentUploadParams {
+    filename: string;
+    content: string;
+}
+/**
+ * A document record.
+ */
+interface Document {
+    id: string;
+    tenant_user_id?: string;
+    filename: string;
+    content?: string;
+    created_at: string;
+}
+
+/**
+ * Resource for uploading, listing, and deleting documents.
+ */
+declare class Documents {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Upload a document.
+     */
+    upload(params: DocumentUploadParams, options?: RequestOptions): Promise<Document>;
+    /**
+     * List all documents. Paginated.
+     */
+    list(params?: {
+        page?: number;
+        perPage?: number;
+    }, options?: RequestOptions): Promise<Page<Document>>;
+    /**
+     * Delete a document by ID.
+     */
+    delete(documentId: string, options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * ICP analysis recommendation.
+ */
+interface ICPAnalysis {
+    recommendation: string;
+}
+/**
+ * Channel recommendation.
+ */
+interface ChannelRecommendation {
+    recommendation: string;
+}
+/**
+ * Sequence strategy recommendation.
+ */
+interface SequenceStrategy {
+    recommendation: string;
+}
+
+/**
+ * Resource for AI-powered recommendations (ICP analysis, channel selection, sequence strategy).
+ */
+declare class Recommendations {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Get an ICP analysis recommendation.
+     */
+    icpAnalysis(options?: RequestOptions): Promise<ICPAnalysis>;
+    /**
+     * Get a channel recommendation.
+     */
+    channel(options?: RequestOptions): Promise<ChannelRecommendation>;
+    /**
+     * Get a sequence strategy recommendation.
+     */
+    sequenceStrategy(options?: RequestOptions): Promise<SequenceStrategy>;
+}
+
+/**
+ * Credit balance for a tenant.
+ */
+interface CreditBalance {
+    id: string;
+    tenant_id: string;
+    credits_remaining: number;
+    credits_used_total: number;
+    last_purchase_at: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * A single usage log entry.
+ */
+interface UsageEntry {
+    id: string;
+    tenant_id: string;
+    tenant_user_id: string;
+    endpoint: string;
+    operation: string;
+    credits_charged: number;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+/**
+ * Aggregated usage summary.
+ */
+interface UsageSummary {
+    summary: UsageSummaryEntry[];
+}
+/**
+ * A single row in a usage summary.
+ */
+interface UsageSummaryEntry {
+    operation: string;
+    total_calls: number;
+    total_credits: number;
+}
+/**
+ * Parameters for listing usage entries.
+ */
+interface UsageListParams {
+    from?: string;
+    to?: string;
+    page?: number;
+}
+
+/**
+ * Resource for credit balance and usage tracking.
+ */
+declare class Billing {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Get the current credit balance.
+     */
+    balance(options?: RequestOptions): Promise<CreditBalance>;
+    /**
+     * List usage entries. Paginated.
+     */
+    usage(params?: UsageListParams, options?: RequestOptions): Promise<Page<UsageEntry>>;
+    /**
+     * Get an aggregated usage summary.
+     */
+    usageSummary(options?: RequestOptions): Promise<UsageSummary>;
+}
+
+/**
+ * Parameters for registering a new user.
+ */
+interface UserRegisterParams {
+    externalUserId: string;
+    aboutMe?: string;
+    icp?: string;
+    cta?: string;
+}
+/**
+ * Parameters for updating a user profile.
+ */
+interface UserUpdateParams {
+    aboutMe?: string;
+    icp?: string;
+    cta?: string;
+}
+/**
+ * A user record.
+ */
+interface User {
+    id: string;
+    tenant_id: string;
+    external_user_id: string;
+    about_me: string;
+    icp: string;
+    cta: string;
+    created_at: string;
+    updated_at: string;
+}
+
+/**
+ * Resource for user registration and profile management.
+ */
+declare class Users {
+    private readonly client;
+    constructor(client: APIClient);
+    /**
+     * Register a new user.
+     */
+    register(params: UserRegisterParams, options?: RequestOptions): Promise<User>;
+    /**
+     * Get the current user's profile.
+     */
+    me(options?: RequestOptions): Promise<User>;
+    /**
+     * Update the current user's profile.
+     */
+    update(params: UserUpdateParams, options?: RequestOptions): Promise<User>;
+}
+
+/**
+ * GeoDedo — the main SDK client.
+ *
+ * ```ts
+ * const client = new GeoDedo({ apiKey: 'gd_live_xxx' });
+ * const contacts = await client.contacts.search({ titles: ['CEO'] });
+ * ```
+ */
+declare class GeoDedo {
+    private readonly _client;
+    /** Contact search, enrichment, and import. */
+    readonly contacts: Contacts;
+    /** Outreach sequence management. */
+    readonly sequences: Sequences;
+    /** Draft generation, review, and sending. */
+    readonly drafts: Drafts;
+    /** Direct message sending (email, LinkedIn, Instagram, SMS). */
+    readonly messages: Messages;
+    /** AI chat assistant. */
+    readonly chat: Chat;
+    /** Channel connection management. */
+    readonly channels: Channels;
+    /** Document upload and management. */
+    readonly documents: Documents;
+    /** AI-powered recommendations. */
+    readonly recommendations: Recommendations;
+    /** Credit balance and usage tracking. */
+    readonly billing: Billing;
+    /** User registration and profile management. */
+    readonly users: Users;
+    constructor(options?: Partial<ClientOptions>);
+}
+
+/**
+ * Base error class for all GeoDedo SDK errors.
+ */
+declare class GeoDedoError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error returned when the API responds with a non-2xx status code.
+ */
+declare class APIError extends GeoDedoError {
+    /** HTTP status code. */
+    readonly status: number;
+    /** Machine-readable error code from the response body, if present. */
+    readonly code: string | undefined;
+    /** Request ID from the X-Request-Id response header, if present. */
+    readonly requestId: string | undefined;
+    /** Raw response body. */
+    readonly body: unknown;
+    constructor(status: number, body: unknown, message: string, code?: string, requestId?: string);
+    /**
+     * Factory that maps an HTTP status code to the appropriate error subclass.
+     */
+    static fromResponse(status: number, body: unknown, headers?: Headers | Record<string, string>): APIError;
+}
+/**
+ * 401 — Invalid or missing API key.
+ */
+declare class AuthenticationError extends APIError {
+    constructor(body: unknown, message: string, code?: string, requestId?: string);
+}
+/**
+ * 402 — Not enough credits to complete the request.
+ */
+declare class InsufficientCreditsError extends APIError {
+    /** Number of credits required for the operation. */
+    readonly creditsRequired: number | undefined;
+    /** Current credit balance. */
+    readonly creditsRemaining: number | undefined;
+    constructor(body: unknown, message: string, code?: string, requestId?: string, creditsRequired?: number, creditsRemaining?: number);
+}
+/**
+ * 403 — Authenticated but not authorized for this operation.
+ */
+declare class PermissionDeniedError extends APIError {
+    constructor(body: unknown, message: string, code?: string, requestId?: string);
+}
+/**
+ * 404 — The requested resource was not found.
+ */
+declare class NotFoundError extends APIError {
+    constructor(body: unknown, message: string, code?: string, requestId?: string);
+}
+/**
+ * 422 — Validation error in the request body or parameters.
+ */
+declare class ValidationError extends APIError {
+    constructor(body: unknown, message: string, code?: string, requestId?: string);
+}
+/**
+ * 429 — Rate limit exceeded.
+ */
+declare class RateLimitError extends APIError {
+    /** Seconds to wait before retrying, from the Retry-After header. */
+    readonly retryAfter: number | undefined;
+    constructor(body: unknown, message: string, code?: string, requestId?: string, retryAfter?: number);
+}
+/**
+ * 5xx — Internal server error.
+ */
+declare class InternalServerError extends APIError {
+    constructor(status: number, body: unknown, message: string, code?: string, requestId?: string);
+}
+/**
+ * Network-level failure (DNS, socket, TLS, etc.).
+ */
+declare class APIConnectionError extends GeoDedoError {
+    /** The underlying error that caused the connection failure. */
+    readonly cause: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Request timed out before receiving a response.
+ */
+declare class APITimeoutError extends APIConnectionError {
+    constructor(message?: string);
+}
+
+export { APIClient, type APIClientOptions, APIConnectionError, APIError, APITimeoutError, AgentMailChannel, type AgentMailCreateParams, type AgentMailCreateResult, AuthenticationError, Billing, type ChannelName, type ChannelRecommendation, type ChannelStatus, Channels, Chat, type ChatCreateParams, type ChatResponse, type CheckpointParams, type ClientOptions, type ConnectionResult, type Contact, type ContactEnrichParams, type ContactImportEntry, type ContactImportParams, type ContactSearchParams, Contacts, type Conversation, type ConversationMessage, ConversationsResource, type CreditBalance, type CsvList, type Document, type DocumentUploadParams, Documents, type Draft, type DraftApproveParams, type DraftApproveResult, type DraftBatchResult, type DraftContact, type DraftGenerateParams, type DraftListParams, type DraftSendError, type DraftSendParams, type DraftSendResult, type DraftUpdateParams, Drafts, type EmailResult, type EmailSendParams, GeoDedo, GeoDedoError, GmailChannel, type GmailConnectResult, type ICPAnalysis, type ImportResult, type InboxChannel, InstagramChannel, type InstagramConnectParams, type InstagramResult, type InstagramSendParams, InsufficientCreditsError, InternalServerError, LinkedInChannel, type LinkedInConnectParams, type LinkedInResult, type LinkedInSendParams, Messages, NotFoundError, Page, type PageRequestOptions, type PageResponse, type PaginationParams, PermissionDeniedError, RateLimitError, Recommendations, type RequestOptions, type Sequence, type SequenceCreateParams, type SequenceStats, type SequenceStrategy, type SequenceWithStats, Sequences, SmsChannel, type SmsConfirmParams, type SmsResult, type SmsSendParams, type SmsVerifyParams, type SmsVerifyResult, type StoredContact, type UsageEntry, type UsageListParams, type UsageSummary, type UsageSummaryEntry, type User, type UserRegisterParams, type UserUpdateParams, Users, ValidationError };