@hasna/contacts 0.6.34 → 0.6.35

package/dist/server/pg-store.d.ts

@@ -0,0 +1,893 @@
+import type { PoolQueryClient } from "../generated/storage-kit/query.js";
+import type { Company, Contact, CreateCompanyInput, CreateContactInput, CreateTagInput, Email, Phone, Tag, UpdateCompanyInput, UpdateContactInput, UpdateTagInput } from "../types/index.js";
+import type { ContactProjectMembershipListResult, ContactProjectMembershipMutationDirection, ContactProjectMembershipMutationInput, ContactProjectMembershipMutationResult, ContactProjectMembershipSnapshot } from "../types/project-memberships.js";
+/**
+ * Contact read responses carry their child collections, matching what the
+ * on-box SQLite store returns from `loadContactDetails`. The ApiStore is typed
+ * against the SQLite return shape, so omitting these here is a silent parity
+ * break rather than a smaller-but-valid response.
+ */
+export type ContactWithMethods = Contact & {
+    tags: Tag[];
+    emails: Email[];
+    phones: Phone[];
+};
+export interface ContactListFilter {
+    limit?: number;
+    offset?: number;
+    company_id?: string;
+    status?: string;
+    tag_id?: string;
+    q?: string;
+}
+export interface CompanyListFilter {
+    limit?: number;
+    offset?: number;
+    industry?: string;
+}
+export declare class ContactsPgStore {
+    private readonly client;
+    constructor(client: PoolQueryClient);
+    /** Attach cloud tag memberships in one query for contact read responses. */
+    private attachTags;
+    /**
+     * Attach email/phone child rows in TWO batched queries regardless of how many
+     * contacts are passed. `loadDetails` below queries per contact, which is
+     * correct for a single row and an N+1 on a list or an export — this is the
+     * list-safe counterpart, shaped like `attachTags` above.
+     */
+    private attachContactMethods;
+    /** The single readback contract for every contact-returning v1 path. */
+    private attachContactDetails;
+    /**
+     * Append emails/phones, skipping duplicates the way the SQLite store does —
+     * case-insensitively on address, exactly on number. `WHERE NOT EXISTS` keeps
+     * the check and the insert in one statement so two concurrent appends of the
+     * same address cannot both pass a separate existence check.
+     */
+    private insertContactMethods;
+    listContacts(filter?: ContactListFilter): Promise<{
+        contacts: ContactWithMethods[];
+        count: number;
+    }>;
+    getContact(id: string): Promise<ContactWithMethods | null>;
+    createContact(input: CreateContactInput): Promise<ContactWithMethods>;
+    updateContact(id: string, input: UpdateContactInput): Promise<ContactWithMethods | null>;
+    deleteContact(id: string): Promise<boolean>;
+    linkContactToProject(contactId: string, projectId: string): Promise<void>;
+    unlinkContactFromProject(contactId: string, projectId: string): Promise<boolean>;
+    getContactProjectIds(contactId: string): Promise<string[]>;
+    setContactProjects(contactId: string, projectIds: string[]): Promise<string[]>;
+    listContactIdsByProject(projectId: string): Promise<string[]>;
+    private contactProjectMembershipState;
+    private transitionContactProjectMembershipWithoutReceipt;
+    readContactProjectMembership(contactId: string, projectId: string): Promise<ContactProjectMembershipSnapshot>;
+    listContactProjectMemberships(projectId: string, maxItems: number): Promise<ContactProjectMembershipListResult>;
+    mutateContactProjectMembership(direction: ContactProjectMembershipMutationDirection, rawInput: ContactProjectMembershipMutationInput): Promise<ContactProjectMembershipMutationResult>;
+    listCompanies(filter?: CompanyListFilter): Promise<{
+        companies: Company[];
+        count: number;
+    }>;
+    getCompany(id: string): Promise<Company | null>;
+    createCompany(input: CreateCompanyInput): Promise<Company>;
+    updateCompany(id: string, input: UpdateCompanyInput): Promise<Company | null>;
+    deleteCompany(id: string): Promise<boolean>;
+    listTags(): Promise<Tag[]>;
+    getTag(id: string): Promise<Tag | null>;
+    getTagByName(name: string): Promise<Tag | null>;
+    createTag(input: CreateTagInput): Promise<Tag>;
+    updateTag(id: string, input: UpdateTagInput): Promise<Tag | null>;
+    deleteTag(id: string): Promise<boolean>;
+    addTagToContact(contactId: string, tagId: string): Promise<void>;
+    removeTagFromContact(contactId: string, tagId: string): Promise<boolean>;
+    stats(): Promise<{
+        contacts: number;
+        companies: number;
+        tags: number;
+    }>;
+    private loadDetails;
+    searchContacts(q: string): Promise<Record<string, unknown>[]>;
+    listColdContacts(days: number): Promise<Record<string, unknown>[]>;
+    listContactsNotContactedSince(days: number, limit: number): Promise<Array<{
+        id: string;
+        display_name: string;
+        last_contacted_at: string | null;
+    }>>;
+    listFollowupDueContacts(onOrBefore: string): Promise<Array<{
+        id: string;
+        display_name: string;
+        follow_up_at: string;
+    }>>;
+    findContactsForContext(topic: string, limit: number): Promise<Array<{
+        id: string;
+        display_name: string;
+        job_title: string | null;
+        reason: string;
+    }>>;
+    findEmailDuplicates(): Promise<Array<{
+        email: string;
+        contact_ids: string[];
+    }>>;
+    findNameDuplicates(): Promise<Array<{
+        contact_ids: [string, string];
+        similarity: number;
+    }>>;
+    getRecentContactEvents(since?: string, eventTypes?: string[]): Promise<Record<string, unknown>[]>;
+    private mapDeal;
+    createDeal(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        title: unknown;
+        contact_id: unknown;
+        company_id: unknown;
+        stage: unknown;
+        value_usd: unknown;
+        currency: unknown;
+        close_date: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    }>;
+    getDeal(id: string): Promise<{
+        id: unknown;
+        title: unknown;
+        contact_id: unknown;
+        company_id: unknown;
+        stage: unknown;
+        value_usd: unknown;
+        currency: unknown;
+        close_date: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    } | null>;
+    listDeals(opts?: {
+        stage?: string;
+        contact_id?: string;
+        company_id?: string;
+    }): Promise<{
+        id: unknown;
+        title: unknown;
+        contact_id: unknown;
+        company_id: unknown;
+        stage: unknown;
+        value_usd: unknown;
+        currency: unknown;
+        close_date: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    updateDeal(id: string, input: Record<string, unknown>): Promise<{
+        id: unknown;
+        title: unknown;
+        contact_id: unknown;
+        company_id: unknown;
+        stage: unknown;
+        value_usd: unknown;
+        currency: unknown;
+        close_date: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    } | null>;
+    deleteDeal(id: string): Promise<boolean>;
+    private mapEvent;
+    logEvent(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        title: unknown;
+        type: unknown;
+        event_date: unknown;
+        duration_min: unknown;
+        contact_ids: string[];
+        company_id: unknown;
+        notes: unknown;
+        outcome: unknown;
+        deal_id: unknown;
+        created_at: string;
+    }>;
+    listEvents(opts?: {
+        contact_id?: string;
+        company_id?: string;
+        type?: string;
+        date_from?: string;
+        date_to?: string;
+    }): Promise<{
+        id: unknown;
+        title: unknown;
+        type: unknown;
+        event_date: unknown;
+        duration_min: unknown;
+        contact_ids: string[];
+        company_id: unknown;
+        notes: unknown;
+        outcome: unknown;
+        deal_id: unknown;
+        created_at: string;
+    }[]>;
+    deleteEvent(id: string): Promise<boolean>;
+    private mapTask;
+    createContactTask(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        title: unknown;
+        description: unknown;
+        contact_id: unknown;
+        assigned_by: unknown;
+        deadline: unknown;
+        status: unknown;
+        priority: unknown;
+        entity_id: unknown;
+        linked_todos_task_id: unknown;
+        escalation_rules: unknown[];
+        created_at: string;
+        updated_at: string;
+    }>;
+    listContactTasks(opts?: {
+        contact_id?: string;
+        entity_id?: string;
+        status?: string;
+        priority?: string;
+    }): Promise<{
+        id: unknown;
+        title: unknown;
+        description: unknown;
+        contact_id: unknown;
+        assigned_by: unknown;
+        deadline: unknown;
+        status: unknown;
+        priority: unknown;
+        entity_id: unknown;
+        linked_todos_task_id: unknown;
+        escalation_rules: unknown[];
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    updateContactTask(id: string, input: Record<string, unknown>): Promise<{
+        id: unknown;
+        title: unknown;
+        description: unknown;
+        contact_id: unknown;
+        assigned_by: unknown;
+        deadline: unknown;
+        status: unknown;
+        priority: unknown;
+        entity_id: unknown;
+        linked_todos_task_id: unknown;
+        escalation_rules: unknown[];
+        created_at: string;
+        updated_at: string;
+    } | null>;
+    deleteContactTask(id: string): Promise<boolean>;
+    listOverdueTasks(): Promise<{
+        id: unknown;
+        title: unknown;
+        description: unknown;
+        contact_id: unknown;
+        assigned_by: unknown;
+        deadline: unknown;
+        status: unknown;
+        priority: unknown;
+        entity_id: unknown;
+        linked_todos_task_id: unknown;
+        escalation_rules: unknown[];
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    checkEscalations(): Promise<{
+        task: Record<string, unknown>;
+        rules_triggered: Array<{
+            after_days: number;
+        }>;
+    }[]>;
+    private mapApplication;
+    createApplication(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        program_name: unknown;
+        provider_company_id: unknown;
+        type: unknown;
+        value_usd: unknown;
+        applicant_contact_id: unknown;
+        primary_contact_id: unknown;
+        status: unknown;
+        submitted_date: unknown;
+        decision_date: unknown;
+        follow_up_date: unknown;
+        notes: unknown;
+        method: {} | null;
+        form_url: unknown;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+    }>;
+    listApplications(opts?: {
+        type?: string;
+        status?: string;
+        provider_company_id?: string;
+        applicant_contact_id?: string;
+    }): Promise<{
+        id: unknown;
+        program_name: unknown;
+        provider_company_id: unknown;
+        type: unknown;
+        value_usd: unknown;
+        applicant_contact_id: unknown;
+        primary_contact_id: unknown;
+        status: unknown;
+        submitted_date: unknown;
+        decision_date: unknown;
+        follow_up_date: unknown;
+        notes: unknown;
+        method: {} | null;
+        form_url: unknown;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    updateApplication(id: string, input: Record<string, unknown>): Promise<{
+        id: unknown;
+        program_name: unknown;
+        provider_company_id: unknown;
+        type: unknown;
+        value_usd: unknown;
+        applicant_contact_id: unknown;
+        primary_contact_id: unknown;
+        status: unknown;
+        submitted_date: unknown;
+        decision_date: unknown;
+        follow_up_date: unknown;
+        notes: unknown;
+        method: {} | null;
+        form_url: unknown;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+    } | null>;
+    listFollowUpDueApplications(): Promise<{
+        id: unknown;
+        program_name: unknown;
+        provider_company_id: unknown;
+        type: unknown;
+        value_usd: unknown;
+        applicant_contact_id: unknown;
+        primary_contact_id: unknown;
+        status: unknown;
+        submitted_date: unknown;
+        decision_date: unknown;
+        follow_up_date: unknown;
+        notes: unknown;
+        method: {} | null;
+        form_url: unknown;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    private mapGroup;
+    createGroup(input: Record<string, unknown>): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    } | null>;
+    getGroup(id: string): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    } | null>;
+    listGroups(projectId?: string): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    }[]>;
+    updateGroup(id: string, input: Record<string, unknown>): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    } | null>;
+    deleteGroup(id: string): Promise<boolean>;
+    addContactToGroup(contactId: string, groupId: string): Promise<{
+        added: boolean;
+        already_member: boolean;
+    }>;
+    removeContactFromGroup(contactId: string, groupId: string): Promise<void>;
+    listContactsInGroup(groupId: string): Promise<string[]>;
+    listGroupsForContact(contactId: string): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    }[]>;
+    addCompanyToGroup(companyId: string, groupId: string): Promise<{
+        added: boolean;
+        already_member: boolean;
+    }>;
+    removeCompanyFromGroup(companyId: string, groupId: string): Promise<void>;
+    listCompaniesInGroup(groupId: string): Promise<string[]>;
+    listGroupsForCompany(companyId: string): Promise<{
+        created_at: string | null;
+        updated_at: string | null;
+        member_count: number | undefined;
+        company_count: number | undefined;
+    }[]>;
+    private mapVendorComm;
+    logVendorCommunication(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        comm_date: unknown;
+        type: unknown;
+        direction: unknown;
+        subject: unknown;
+        body: unknown;
+        status: unknown;
+        invoice_amount: unknown;
+        invoice_currency: unknown;
+        invoice_ref: unknown;
+        follow_up_date: unknown;
+        follow_up_done: boolean;
+        created_at: string;
+    }>;
+    listVendorCommunications(companyId: string, opts?: {
+        type?: string;
+        status?: string;
+        direction?: string;
+    }): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        comm_date: unknown;
+        type: unknown;
+        direction: unknown;
+        subject: unknown;
+        body: unknown;
+        status: unknown;
+        invoice_amount: unknown;
+        invoice_currency: unknown;
+        invoice_ref: unknown;
+        follow_up_date: unknown;
+        follow_up_done: boolean;
+        created_at: string;
+    }[]>;
+    listMissingInvoices(): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        comm_date: unknown;
+        type: unknown;
+        direction: unknown;
+        subject: unknown;
+        body: unknown;
+        status: unknown;
+        invoice_amount: unknown;
+        invoice_currency: unknown;
+        invoice_ref: unknown;
+        follow_up_date: unknown;
+        follow_up_done: boolean;
+        created_at: string;
+    }[]>;
+    listPendingFollowUps(): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        comm_date: unknown;
+        type: unknown;
+        direction: unknown;
+        subject: unknown;
+        body: unknown;
+        status: unknown;
+        invoice_amount: unknown;
+        invoice_currency: unknown;
+        invoice_ref: unknown;
+        follow_up_date: unknown;
+        follow_up_done: boolean;
+        created_at: string;
+    }[]>;
+    markFollowUpDone(id: string): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        comm_date: unknown;
+        type: unknown;
+        direction: unknown;
+        subject: unknown;
+        body: unknown;
+        status: unknown;
+        invoice_amount: unknown;
+        invoice_currency: unknown;
+        invoice_ref: unknown;
+        follow_up_date: unknown;
+        follow_up_done: boolean;
+        created_at: string;
+    } | null>;
+    private mapOrgMember;
+    addOrgMember(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        title: unknown;
+        specialization: unknown;
+        office_phone: unknown;
+        response_sla_hours: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    }>;
+    listOrgMembers(companyId: string): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        title: unknown;
+        specialization: unknown;
+        office_phone: unknown;
+        response_sla_hours: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    updateOrgMember(id: string, input: Record<string, unknown>): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        title: unknown;
+        specialization: unknown;
+        office_phone: unknown;
+        response_sla_hours: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    } | null>;
+    removeOrgMember(id: string): Promise<boolean>;
+    listOrgMembersForContact(contactId: string): Promise<{
+        id: unknown;
+        company_id: unknown;
+        contact_id: unknown;
+        title: unknown;
+        specialization: unknown;
+        office_phone: unknown;
+        response_sla_hours: unknown;
+        notes: unknown;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    private mapNote;
+    addNote(contactId: string, body: string, createdBy?: string, companyId?: string): Promise<Record<string, unknown>>;
+    listNotes(contactId: string): Promise<Record<string, unknown>[]>;
+    listNotesForContactAtCompany(contactId: string, companyId: string): Promise<Record<string, unknown>[]>;
+    deleteNote(noteId: string): Promise<void>;
+    createRelationship(input: Record<string, unknown>): Promise<{
+        created_at: string | null;
+    }>;
+    listRelationships(opts?: {
+        contact_id?: string;
+    }): Promise<Record<string, unknown>[]>;
+    deleteRelationship(id: string): Promise<void>;
+    createCompanyRelationship(input: Record<string, unknown>): Promise<{
+        created_at: string | null;
+        is_primary: boolean;
+    }>;
+    listCompanyRelationships(opts?: {
+        contact_id?: string;
+        company_id?: string;
+    }): Promise<Record<string, unknown>[]>;
+    deleteCompanyRelationship(id: string): Promise<void>;
+    getFieldHistory(contactId: string, fieldName?: string): Promise<{
+        valid_from: string | null;
+        created_at: string | null;
+    }[]>;
+    getContactAt(contactId: string, timestamp: string): Promise<Record<string, string>>;
+    private mapJob;
+    addJobEntry(contactId: string, input: Record<string, unknown>): Promise<{
+        is_current: boolean;
+        inferred: boolean;
+        created_at: string | null;
+    }>;
+    getJobHistory(contactId: string): Promise<{
+        is_current: boolean;
+        inferred: boolean;
+        created_at: string | null;
+    }[]>;
+    private mapLearning;
+    saveLearning(contactId: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getLearnings(contactId: string, opts?: {
+        type?: string;
+        min_importance?: number;
+        visibility?: string;
+    }): Promise<Record<string, unknown>[]>;
+    searchLearnings(query: string, opts?: {
+        type?: string;
+        contact_id?: string;
+    }): Promise<Record<string, unknown>[]>;
+    confirmLearning(learningId: string): Promise<void>;
+    getStaleLearnings(daysOld: number, minConfidence: number): Promise<Record<string, unknown>[]>;
+    runLearningMaintenance(): Promise<{
+        decayed_count: number;
+        potential_contradictions: Record<string, unknown>[];
+    }>;
+    private mapLock;
+    acquireContactLock(contactId: string, agentName: string, ttlSeconds?: number, reason?: string, sessionId?: string): Promise<{
+        acquired: boolean;
+        held_by: unknown;
+        lock: {
+            acquired_at: string | null;
+            expires_at: string | null;
+        };
+    } | {
+        acquired: boolean;
+        lock: {
+            acquired_at: string | null;
+            expires_at: string | null;
+        };
+        held_by?: undefined;
+    }>;
+    releaseContactLock(contactId: string, agentName: string): Promise<boolean>;
+    checkContactLock(contactId: string): Promise<{
+        acquired_at: string | null;
+        expires_at: string | null;
+    } | null>;
+    logAgentActivity(contactId: string, agentName: string, action: string, details?: string, sessionId?: string): Promise<void>;
+    getAgentActivity(contactId: string, limit?: number): Promise<{
+        created_at: string | null;
+    }[]>;
+    resolveContactIdentity(partial: {
+        name?: string;
+        email?: string;
+        phone?: string;
+        linkedin_url?: string;
+    }): Promise<{
+        contact: {
+            id: string;
+            display_name: string;
+            job_title?: string;
+        };
+        confidence_score: number;
+        match_reasons: string[];
+    }[]>;
+    addContactIdentity(contactId: string, system: string, externalId: string, externalUrl?: string, confidence?: "verified" | "inferred"): Promise<{
+        created_at: string | null;
+    }>;
+    getContactIdentities(contactId: string): Promise<{
+        created_at: string | null;
+    }[]>;
+    private signalRow;
+    getRelationshipSignals(contactId: string): Promise<{
+        signal_type: string;
+        reason: string;
+        contact_id: unknown;
+        display_name: unknown;
+        last_contacted_at: string | null;
+        interaction_count_30d: number;
+        engagement_status: {} | null;
+        relationship_health: {} | null;
+        days_since_contact: number | null;
+    }[]>;
+    getGhostContacts(): Promise<{
+        signal_type: string;
+        reason: string;
+        contact_id: unknown;
+        display_name: unknown;
+        last_contacted_at: string | null;
+        interaction_count_30d: number;
+        engagement_status: {} | null;
+        relationship_health: {} | null;
+        days_since_contact: number | null;
+    }[]>;
+    getWarmingContacts(): Promise<{
+        signal_type: string;
+        reason: string;
+        contact_id: unknown;
+        display_name: unknown;
+        last_contacted_at: string | null;
+        interaction_count_30d: number;
+        engagement_status: {} | null;
+        relationship_health: {} | null;
+        days_since_contact: number | null;
+    }[]>;
+    recomputeSignals(): Promise<{
+        updated: number;
+    }>;
+    getFreshnessScore(contactId: string): Promise<{
+        contact_id: string;
+        overall_score: number;
+        fields: {
+            field_name: string;
+            value: string | null;
+            last_verified_at: string | null;
+            source: string | null;
+            confidence: string;
+            days_old: number | null;
+        }[];
+        stale_fields: string[];
+        verified_fields: string[];
+    }>;
+    getStaleContacts(threshold?: number): Promise<{
+        contact_id: string;
+        display_name: string;
+        score: number;
+    }[]>;
+    markFieldVerified(contactId: string, fieldName: string, source?: string): Promise<void>;
+    computeRelationshipStrength(contactId: string): Promise<number>;
+    findWarmPath(fromContactId: string, toContactId: string): Promise<{
+        contact_id: string;
+        display_name: string;
+        strength: number;
+    }[]>;
+    findConnectionsAtCompany(companyId: string): Promise<{
+        contact_id: string;
+        display_name: string;
+        job_title?: string;
+        strength: number;
+    }[]>;
+    detectCoolingRelationships(): Promise<{
+        contact_id: string;
+        display_name: string;
+        days_since: number;
+    }[]>;
+    addOrgChartEdge(companyId: string, contactAId: string, contactBId: string, edgeType: string, inferred?: boolean): Promise<{
+        inferred: boolean;
+        created_at: string | null;
+    }>;
+    listOrgChart(companyId: string): Promise<{
+        contact_a_name: string;
+        contact_b_name: string;
+        edge_type: string;
+    }[]>;
+    setDealContactRole(dealId: string, contactId: string, accountRole: string): Promise<{
+        created_at: string | null;
+    }>;
+    getDealTeam(dealId: string): Promise<{
+        display_name: string;
+        account_role: string;
+        job_title?: string;
+    }[]>;
+    getCoverageGaps(companyId: string): Promise<{
+        covered: string[];
+        missing_key_roles: string[];
+    }>;
+    private mapAudience;
+    createAudience(input: Record<string, unknown>): Promise<{
+        id: unknown;
+        audience_id: unknown;
+        name: unknown;
+        match: unknown;
+        predicates: unknown[];
+        consent_policy: unknown;
+        suppression_synced_at: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+    getAudience(idOrSlug: string): Promise<{
+        id: unknown;
+        audience_id: unknown;
+        name: unknown;
+        match: unknown;
+        predicates: unknown[];
+        consent_policy: unknown;
+        suppression_synced_at: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+    listAudiences(): Promise<{
+        id: unknown;
+        audience_id: unknown;
+        name: unknown;
+        match: unknown;
+        predicates: unknown[];
+        consent_policy: unknown;
+        suppression_synced_at: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }[]>;
+    updateAudience(idOrSlug: string, input: Record<string, unknown>): Promise<{
+        id: unknown;
+        audience_id: unknown;
+        name: unknown;
+        match: unknown;
+        predicates: unknown[];
+        consent_policy: unknown;
+        suppression_synced_at: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+    deleteAudience(idOrSlug: string): Promise<void>;
+    setContactConsent(contactId: string, channel: string, status: string, source?: string): Promise<{
+        updated_at: string | null;
+    }>;
+    listContactConsent(contactId: string): Promise<{
+        updated_at: string | null;
+    }[]>;
+    suppressAddress(input: {
+        channel: string;
+        address: string;
+        contact_id?: string;
+        reason?: string;
+    }): Promise<{
+        created_at: string | null;
+        synced_at: string | null;
+    }>;
+    unsuppressAddress(channel: string, address: string): Promise<void>;
+    listSuppressions(opts?: {
+        channel?: string;
+        unsyncedOnly?: boolean;
+    }): Promise<{
+        created_at: string | null;
+        synced_at: string | null;
+    }[]>;
+    resolveAudience(idOrSlug: string, channel: string): Promise<{
+        audience_id: unknown;
+        channel: string;
+        consent_policy: unknown;
+        matched: number;
+        recipients: {
+            contact_id: string;
+            display_name: string;
+            address: string;
+            consent_status: string;
+        }[];
+        excluded: {
+            contact_id: string;
+            reason: string;
+        }[];
+    }>;
+    getUpcomingItems(days?: number): Promise<Record<string, unknown>[]>;
+    listContactAudit(): Promise<{
+        contact_id: string;
+        display_name: string;
+        score: number;
+        missing: string[];
+        suggestions: string[];
+    }[]>;
+    getContactTimeline(contactId: string, limit?: number): Promise<{
+        date: string;
+        type: string;
+        title: string;
+        body?: string;
+        metadata?: Record<string, unknown>;
+    }[]>;
+    getNetworkStats(): Promise<{
+        total_contacts: number;
+        total_companies: number;
+        owned_entities: number;
+        total_tags: number;
+        total_groups: number;
+        total_deals: number;
+        total_events: number;
+        cold_30d: number;
+        cold_60d: number;
+        cold_never: number;
+        contacts_with_email: number;
+        contacts_with_phone: number;
+        contacts_no_company: number;
+        overdue_tasks: number;
+        pending_applications: number;
+        missing_invoices: number;
+        upcoming_7d: number;
+        notes_count: number;
+        active_deals_value: number;
+    }>;
+    getContactCard(contactId: string): Promise<{
+        id: string;
+        display_name: string;
+        job_title: string | null;
+        company: string | undefined;
+        primary_email: string | undefined;
+        primary_phone: string | undefined;
+    }>;
+    getContactBrief(contactId: string, taskContext?: string): Promise<Record<string, unknown>>;
+    assembleContext(contactIds: string[], format: string): Promise<{
+        format: string;
+        contact_count: number;
+        assembled_at: string;
+        contacts: Record<string, unknown>[];
+    }>;
+    generateBrief(contactId: string): Promise<string>;
+    vaultStatus(): Promise<{
+        initialized: boolean;
+        unlocked: boolean;
+        document_count: number;
+    }>;
+}
+export declare function createContactsPgStore(client: PoolQueryClient): ContactsPgStore;
+export declare function getContactsPgStore(client: PoolQueryClient): ContactsPgStore;
+export declare function resetContactsPgStore(): void;
+//# sourceMappingURL=pg-store.d.ts.map