@btst/stack 5.0.0 → 5.2.0

package/dist/plugins/crm/api/index.d.cts

@@ -0,0 +1,1007 @@
+import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
+import { DeepReadonly } from '@btst/stack/plugins/api';
+import { PermissionDescriptor } from '../../../authorization/index.cjs';
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod from 'zod';
+import { z } from 'zod';
+import * as better_call from 'better-call';
+import { k as CrmPluginHooks, b as Contact, d as Company, P as Pipeline, D as Deal, A as Activity, l as ActivityRecord, m as CompanyRecord, n as ContactRecord, o as DealRecord, p as listActivitiesSchema, q as listCompaniesSchema, r as listContactsSchema, s as listDealsSchema, t as paginationSchema, u as createCompanySchema, v as createContactSchema, w as createDealSchema, x as createPipelineSchema, y as createActivitySchema, z as updateActivitySchema, B as updateCompanySchema, E as updateContactSchema, F as updateDealSchema } from '../../../shared/stack.Dm40g5Ps.cjs';
+export { h as ActivityInput, i as ActivityUpdateInput, e as CompanyInput, c as ContactInput, G as CrmHookContext, C as CrmListParams, f as DealInput, g as DealUpdateInput, j as PipelineInput, H as createCrmQueryKeys, I as crmResources } from '../../../shared/stack.Dm40g5Ps.cjs';
+import * as _btst_db from '@btst/db';
+import { DBAdapter } from '@btst/db';
+export { crmPermissions } from '../permissions.cjs';
+import '@btst/stack/plugins/client';
+import '@btst/stack/context';
+import '@btst/stack/authorization';
+
+/** CRM lifecycle configuration. Shared API and authorization settings belong to the stack. */
+interface CrmBackendOptions {
+    /** Post-authorization lifecycle hooks and follow-up notification delivery. */ hooks?: CrmPluginHooks;
+}
+/** Private contacts, Kanban-backed deals and activity tracking. Requires the Kanban backend plugin. */
+declare const crmBackendPlugin: (options?: CrmBackendOptions) => _btst_stack_plugins_api.BackendPlugin<{
+    listContacts: better_call.StrictEndpoint<"/crm/contacts", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            limit?: unknown;
+            offset?: unknown;
+            search?: string | undefined;
+            tag?: string | undefined;
+            companyId?: string | undefined;
+        }, {
+            limit?: unknown;
+            offset?: unknown;
+            search?: string | undefined;
+            tag?: string | undefined;
+            companyId?: string | undefined;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly firstName: string;
+            readonly lastName?: string | null | undefined;
+            readonly email?: string | null | undefined;
+            readonly phone?: string | null | undefined;
+            readonly company?: string | null | undefined;
+            readonly companyId?: string | null | undefined;
+            readonly title?: string | null | undefined;
+            readonly notes?: string | null | undefined;
+            readonly tags: readonly string[];
+            readonly customFields: {
+                readonly [x: string]: string;
+            };
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    getContactById: better_call.StrictEndpoint<"/crm/contacts/:id", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly id: string;
+        readonly firstName: string;
+        readonly lastName?: string | null | undefined;
+        readonly email?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly company?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly title?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly tags: readonly string[];
+        readonly customFields: {
+            readonly [x: string]: string;
+        };
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    createContact: better_call.StrictEndpoint<"/crm/contacts", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            firstName: string;
+            lastName?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            company?: string | null | undefined;
+            companyId?: string | null | undefined;
+            title?: string | null | undefined;
+            notes?: string | null | undefined;
+            tags?: string[] | undefined;
+            customFields?: Record<string, string> | undefined;
+        }, {
+            firstName: string;
+            lastName?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            company?: string | null | undefined;
+            companyId?: string | null | undefined;
+            title?: string | null | undefined;
+            notes?: string | null | undefined;
+            tags?: string[] | undefined;
+            customFields?: Record<string, string> | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly firstName: string;
+        readonly lastName?: string | null | undefined;
+        readonly email?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly company?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly title?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly tags: readonly string[];
+        readonly customFields: {
+            readonly [x: string]: string;
+        };
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    updateContact: better_call.StrictEndpoint<"/crm/contacts/:id", {
+        requireRequest: true;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            firstName?: string | undefined;
+            lastName?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            company?: string | null | undefined;
+            companyId?: string | null | undefined;
+            title?: string | null | undefined;
+            notes?: string | null | undefined;
+            tags?: string[] | undefined;
+            customFields?: Record<string, string> | undefined;
+        }, {
+            firstName?: string | undefined;
+            lastName?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            company?: string | null | undefined;
+            companyId?: string | null | undefined;
+            title?: string | null | undefined;
+            notes?: string | null | undefined;
+            tags?: string[] | undefined;
+            customFields?: Record<string, string> | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly firstName: string;
+        readonly lastName?: string | null | undefined;
+        readonly email?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly company?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly title?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly tags: readonly string[];
+        readonly customFields: {
+            readonly [x: string]: string;
+        };
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    deleteContact: better_call.StrictEndpoint<"/crm/contacts/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+    listCompanies: better_call.StrictEndpoint<"/crm/companies", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            limit?: unknown;
+            offset?: unknown;
+            search?: string | undefined;
+        }, {
+            limit?: unknown;
+            offset?: unknown;
+            search?: string | undefined;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly name: string;
+            readonly domain?: string | null | undefined;
+            readonly phone?: string | null | undefined;
+            readonly notes?: string | null | undefined;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    getCompanyById: better_call.StrictEndpoint<"/crm/companies/:id", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly id: string;
+        readonly name: string;
+        readonly domain?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    createCompany: better_call.StrictEndpoint<"/crm/companies", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            name: string;
+            domain?: string | null | undefined;
+            phone?: string | null | undefined;
+            notes?: string | null | undefined;
+        }, {
+            name: string;
+            domain?: string | null | undefined;
+            phone?: string | null | undefined;
+            notes?: string | null | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly name: string;
+        readonly domain?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    updateCompany: better_call.StrictEndpoint<"/crm/companies/:id", {
+        requireRequest: true;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            name?: string | undefined;
+            domain?: string | null | undefined;
+            phone?: string | null | undefined;
+            notes?: string | null | undefined;
+        }, {
+            name?: string | undefined;
+            domain?: string | null | undefined;
+            phone?: string | null | undefined;
+            notes?: string | null | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly name: string;
+        readonly domain?: string | null | undefined;
+        readonly phone?: string | null | undefined;
+        readonly notes?: string | null | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    deleteCompany: better_call.StrictEndpoint<"/crm/companies/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+    listDeals: better_call.StrictEndpoint<"/crm/deals", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            limit?: unknown;
+            offset?: unknown;
+            pipelineId?: string | undefined;
+            contactId?: string | undefined;
+            companyId?: string | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }, {
+            limit?: unknown;
+            offset?: unknown;
+            pipelineId?: string | undefined;
+            contactId?: string | undefined;
+            companyId?: string | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly taskId: string;
+            readonly title: string;
+            readonly value?: number | null | undefined;
+            readonly currency: string;
+            readonly stage: string;
+            readonly pipelineId: string;
+            readonly contactId?: string | null | undefined;
+            readonly companyId?: string | null | undefined;
+            readonly closeDate?: string | null | undefined;
+            readonly status: "open" | "won" | "lost";
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    getDealById: better_call.StrictEndpoint<"/crm/deals/:id", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly id: string;
+        readonly taskId: string;
+        readonly title: string;
+        readonly value?: number | null | undefined;
+        readonly currency: string;
+        readonly stage: string;
+        readonly pipelineId: string;
+        readonly contactId?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly closeDate?: string | null | undefined;
+        readonly status: "open" | "won" | "lost";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    createDeal: better_call.StrictEndpoint<"/crm/deals", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            title: string;
+            stage: string;
+            pipelineId: string;
+            value?: number | null | undefined;
+            currency?: string | undefined;
+            contactId?: string | null | undefined;
+            companyId?: string | null | undefined;
+            closeDate?: string | null | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }, {
+            title: string;
+            stage: string;
+            pipelineId: string;
+            value?: number | null | undefined;
+            currency?: string | undefined;
+            contactId?: string | null | undefined;
+            companyId?: string | null | undefined;
+            closeDate?: string | null | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly taskId: string;
+        readonly title: string;
+        readonly value?: number | null | undefined;
+        readonly currency: string;
+        readonly stage: string;
+        readonly pipelineId: string;
+        readonly contactId?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly closeDate?: string | null | undefined;
+        readonly status: "open" | "won" | "lost";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    updateDeal: better_call.StrictEndpoint<"/crm/deals/:id", {
+        requireRequest: true;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            value?: number | null | undefined;
+            title?: string | undefined;
+            contactId?: string | null | undefined;
+            companyId?: string | null | undefined;
+            closeDate?: string | null | undefined;
+            currency?: string | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }, {
+            value?: number | null | undefined;
+            title?: string | undefined;
+            contactId?: string | null | undefined;
+            companyId?: string | null | undefined;
+            closeDate?: string | null | undefined;
+            currency?: string | undefined;
+            status?: "open" | "won" | "lost" | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly taskId: string;
+        readonly title: string;
+        readonly value?: number | null | undefined;
+        readonly currency: string;
+        readonly stage: string;
+        readonly pipelineId: string;
+        readonly contactId?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly closeDate?: string | null | undefined;
+        readonly status: "open" | "won" | "lost";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    deleteDeal: better_call.StrictEndpoint<"/crm/deals/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+    listPipelines: better_call.StrictEndpoint<"/crm/pipelines", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly deals: readonly {
+                readonly id: string;
+                readonly taskId: string;
+                readonly title: string;
+                readonly value?: number | null | undefined;
+                readonly currency: string;
+                readonly stage: string;
+                readonly pipelineId: string;
+                readonly contactId?: string | null | undefined;
+                readonly companyId?: string | null | undefined;
+                readonly closeDate?: string | null | undefined;
+                readonly status: "open" | "won" | "lost";
+                readonly createdAt: string;
+                readonly updatedAt: string;
+            }[];
+            readonly id: string;
+            readonly name: string;
+            readonly slug: string;
+            readonly description?: string | undefined;
+            readonly ownerId?: string | undefined;
+            readonly organizationId?: string | undefined;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+            readonly columns: readonly {
+                readonly id: string;
+                readonly title: string;
+                readonly order: number;
+                readonly boardId: string;
+                readonly createdAt: string;
+                readonly updatedAt: string;
+                readonly tasks: readonly {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly description?: string | undefined;
+                    readonly priority: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+                    readonly order: number;
+                    readonly columnId: string;
+                    readonly assigneeId?: string | null | undefined;
+                    readonly completedAt?: string | undefined;
+                    readonly isArchived: boolean;
+                    readonly createdAt: string;
+                    readonly updatedAt: string;
+                }[];
+            }[];
+        }[];
+        readonly total: number;
+    }>;
+    getPipeline: better_call.StrictEndpoint<"/crm/pipelines/:id", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly deals: readonly {
+            readonly id: string;
+            readonly taskId: string;
+            readonly title: string;
+            readonly value?: number | null | undefined;
+            readonly currency: string;
+            readonly stage: string;
+            readonly pipelineId: string;
+            readonly contactId?: string | null | undefined;
+            readonly companyId?: string | null | undefined;
+            readonly closeDate?: string | null | undefined;
+            readonly status: "open" | "won" | "lost";
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly id: string;
+        readonly name: string;
+        readonly slug: string;
+        readonly description?: string | undefined;
+        readonly ownerId?: string | undefined;
+        readonly organizationId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly columns: readonly {
+            readonly id: string;
+            readonly title: string;
+            readonly order: number;
+            readonly boardId: string;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+            readonly tasks: readonly {
+                readonly id: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly priority: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+                readonly order: number;
+                readonly columnId: string;
+                readonly assigneeId?: string | null | undefined;
+                readonly completedAt?: string | undefined;
+                readonly isArchived: boolean;
+                readonly createdAt: string;
+                readonly updatedAt: string;
+            }[];
+        }[];
+    }>;
+    createPipeline: better_call.StrictEndpoint<"/crm/pipelines", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            name: string;
+            slug?: string | undefined;
+            stages?: string[] | undefined;
+        }, {
+            name: string;
+            slug?: string | undefined;
+            stages?: string[] | undefined;
+        }>;
+    }, {
+        readonly deals: readonly {
+            readonly id: string;
+            readonly taskId: string;
+            readonly title: string;
+            readonly value?: number | null | undefined;
+            readonly currency: string;
+            readonly stage: string;
+            readonly pipelineId: string;
+            readonly contactId?: string | null | undefined;
+            readonly companyId?: string | null | undefined;
+            readonly closeDate?: string | null | undefined;
+            readonly status: "open" | "won" | "lost";
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly id: string;
+        readonly name: string;
+        readonly slug: string;
+        readonly description?: string | undefined;
+        readonly ownerId?: string | undefined;
+        readonly organizationId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly columns: readonly {
+            readonly id: string;
+            readonly title: string;
+            readonly order: number;
+            readonly boardId: string;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+            readonly tasks: readonly {
+                readonly id: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly priority: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+                readonly order: number;
+                readonly columnId: string;
+                readonly assigneeId?: string | null | undefined;
+                readonly completedAt?: string | undefined;
+                readonly isArchived: boolean;
+                readonly createdAt: string;
+                readonly updatedAt: string;
+            }[];
+        }[];
+    }>;
+    moveDeal: better_call.StrictEndpoint<"/crm/deals/:id/move", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            stage: string;
+            order?: number | undefined;
+        }, {
+            stage: string;
+            order?: number | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly taskId: string;
+        readonly title: string;
+        readonly value?: number | null | undefined;
+        readonly currency: string;
+        readonly stage: string;
+        readonly pipelineId: string;
+        readonly contactId?: string | null | undefined;
+        readonly companyId?: string | null | undefined;
+        readonly closeDate?: string | null | undefined;
+        readonly status: "open" | "won" | "lost";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    listActivities: better_call.StrictEndpoint<"/crm/activities", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            limit?: unknown;
+            offset?: unknown;
+            contactId?: string | undefined;
+            dealId?: string | undefined;
+        }, {
+            limit?: unknown;
+            offset?: unknown;
+            contactId?: string | undefined;
+            dealId?: string | undefined;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly type: "note" | "call" | "email" | "meeting";
+            readonly body: string;
+            readonly contactId?: string | null | undefined;
+            readonly dealId?: string | null | undefined;
+            readonly dueAt?: string | null | undefined;
+            readonly completedAt?: string | null | undefined;
+            readonly remindedAt?: string | null | undefined;
+            readonly createdAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    logActivity: better_call.StrictEndpoint<"/crm/activities", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            type: "email" | "note" | "call" | "meeting";
+            body: string;
+            contactId?: string | null | undefined;
+            dealId?: string | null | undefined;
+            dueAt?: string | null | undefined;
+        }, {
+            type: "email" | "note" | "call" | "meeting";
+            body: string;
+            contactId?: string | null | undefined;
+            dealId?: string | null | undefined;
+            dueAt?: string | null | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly type: "note" | "call" | "email" | "meeting";
+        readonly body: string;
+        readonly contactId?: string | null | undefined;
+        readonly dealId?: string | null | undefined;
+        readonly dueAt?: string | null | undefined;
+        readonly completedAt?: string | null | undefined;
+        readonly remindedAt?: string | null | undefined;
+        readonly createdAt: string;
+    }>;
+    updateActivity: better_call.StrictEndpoint<"/crm/activities/:id", {
+        requireRequest: true;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            body?: string | undefined;
+            dueAt?: string | null | undefined;
+            completedAt?: string | null | undefined;
+        }, {
+            body?: string | undefined;
+            dueAt?: string | null | undefined;
+            completedAt?: string | null | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly type: "note" | "call" | "email" | "meeting";
+        readonly body: string;
+        readonly contactId?: string | null | undefined;
+        readonly dealId?: string | null | undefined;
+        readonly dueAt?: string | null | undefined;
+        readonly completedAt?: string | null | undefined;
+        readonly remindedAt?: string | null | undefined;
+        readonly createdAt: string;
+    }>;
+    deleteActivity: better_call.StrictEndpoint<"/crm/activities/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+    sendDueReminders: better_call.StrictEndpoint<"/crm/reminders/send", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly sent: number;
+    }>;
+}, never, {
+    listContacts: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        search: zod.ZodOptional<zod.ZodString>;
+        tag: zod.ZodOptional<zod.ZodString>;
+        companyId: zod.ZodOptional<zod.ZodString>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:contact.read", undefined>, {
+        items: Contact[];
+        total: number;
+    }, false>;
+    getContactById: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:contact.read", undefined>, Contact, false>;
+    createContact: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        firstName: zod.ZodString;
+        lastName: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        email: zod.ZodOptional<zod.ZodNullable<zod.ZodEmail>>;
+        phone: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        company: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        companyId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        title: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        notes: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        tags: zod.ZodDefault<zod.ZodArray<zod.ZodString>>;
+        customFields: zod.ZodDefault<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:contact.create", undefined>, Contact, false>;
+    updateContact: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            firstName: zod.ZodOptional<zod.ZodString>;
+            lastName: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            email: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodEmail>>>;
+            phone: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            company: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            companyId: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            title: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            notes: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            tags: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
+            customFields: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:contact.update", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, Contact, false>;
+    deleteContact: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:contact.delete", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, {
+        success: true;
+    }, false>;
+    listCompanies: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        search: zod.ZodOptional<zod.ZodString>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:company.read", undefined>, {
+        items: Company[];
+        total: number;
+    }, false>;
+    getCompanyById: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:company.read", undefined>, Company, false>;
+    createCompany: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        name: zod.ZodString;
+        domain: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        phone: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        notes: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:company.create", undefined>, Company, false>;
+    updateCompany: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            name: zod.ZodOptional<zod.ZodString>;
+            domain: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            phone: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            notes: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:company.update", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, Company, false>;
+    deleteCompany: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:company.delete", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, {
+        success: true;
+    }, false>;
+    listPipelines: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:pipeline.read", undefined>, {
+        items: Pipeline[];
+        total: number;
+    }, false>;
+    getPipeline: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:pipeline.read", undefined>, Pipeline, false>;
+    createPipeline: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        name: zod.ZodString;
+        slug: zod.ZodOptional<zod.ZodString>;
+        stages: zod.ZodDefault<zod.ZodArray<zod.ZodString>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:pipeline.create", undefined>, Pipeline, false>;
+    listDeals: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        pipelineId: zod.ZodOptional<zod.ZodString>;
+        contactId: zod.ZodOptional<zod.ZodString>;
+        companyId: zod.ZodOptional<zod.ZodString>;
+        status: zod.ZodOptional<zod.ZodEnum<{
+            open: "open";
+            won: "won";
+            lost: "lost";
+        }>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.read", undefined>, {
+        items: Deal[];
+        total: number;
+    }, false>;
+    getDealById: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.read", undefined>, Deal, false>;
+    createDeal: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        title: zod.ZodString;
+        value: zod.ZodOptional<zod.ZodNullable<zod.ZodNumber>>;
+        currency: zod.ZodDefault<zod.ZodString>;
+        stage: zod.ZodString;
+        pipelineId: zod.ZodString;
+        contactId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        companyId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        closeDate: zod.ZodOptional<zod.ZodNullable<zod.ZodISODateTime>>;
+        status: zod.ZodDefault<zod.ZodEnum<{
+            open: "open";
+            won: "won";
+            lost: "lost";
+        }>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.create", zod.ZodObject<{
+        pipelineId: zod.ZodString;
+        stage: zod.ZodString;
+        contactId: zod.ZodNullable<zod.ZodString>;
+        companyId: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core.$strip>>, Deal, false>;
+    updateDeal: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            value: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodNumber>>>;
+            title: zod.ZodOptional<zod.ZodString>;
+            contactId: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            companyId: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodString>>>;
+            closeDate: zod.ZodOptional<zod.ZodOptional<zod.ZodNullable<zod.ZodISODateTime>>>;
+            currency: zod.ZodOptional<zod.ZodString>;
+            status: zod.ZodOptional<zod.ZodEnum<{
+                open: "open";
+                won: "won";
+                lost: "lost";
+            }>>;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.update", zod.ZodObject<{
+        id: zod.ZodString;
+        pipelineId: zod.ZodString;
+        contactId: zod.ZodNullable<zod.ZodString>;
+        companyId: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core.$strip>>, Deal, false>;
+    deleteDeal: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.delete", zod.ZodObject<{
+        id: zod.ZodString;
+        pipelineId: zod.ZodString;
+        contactId: zod.ZodNullable<zod.ZodString>;
+        companyId: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core.$strip>>, {
+        success: true;
+    }, false>;
+    moveDeal: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        stage: zod.ZodString;
+        order: zod.ZodOptional<zod.ZodNumber>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:deal.move", zod.ZodObject<{
+        id: zod.ZodString;
+        pipelineId: zod.ZodString;
+        contactId: zod.ZodNullable<zod.ZodString>;
+        companyId: zod.ZodNullable<zod.ZodString>;
+        targetStage: zod.ZodString;
+    }, zod_v4_core.$strip>>, Deal, false>;
+    listActivities: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
+        contactId: zod.ZodOptional<zod.ZodString>;
+        dealId: zod.ZodOptional<zod.ZodString>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:activity.read", undefined>, {
+        items: Activity[];
+        total: number;
+    }, false>;
+    logActivity: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        type: zod.ZodEnum<{
+            email: "email";
+            note: "note";
+            call: "call";
+            meeting: "meeting";
+        }>;
+        body: zod.ZodString;
+        contactId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        dealId: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        dueAt: zod.ZodOptional<zod.ZodNullable<zod.ZodISODateTime>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:activity.create", zod.ZodObject<{
+        contactId: zod.ZodNullable<zod.ZodString>;
+        dealId: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core.$strip>>, Activity, false>;
+    updateActivity: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            body: zod.ZodOptional<zod.ZodString>;
+            dueAt: zod.ZodOptional<zod.ZodNullable<zod.ZodISODateTime>>;
+            completedAt: zod.ZodOptional<zod.ZodNullable<zod.ZodISODateTime>>;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:activity.update", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, Activity, false>;
+    deleteActivity: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"crm:activity.delete", zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>>, {
+        success: true;
+    }, false>;
+    sendDueReminders: _btst_stack_plugins_api.Operation<zod.ZodObject<{}, zod_v4_core.$strip>, PermissionDescriptor<"crm:reminder.run", undefined>, {
+        sent: number;
+    }, false>;
+}, "crm">;
+type CrmApiRouter = ReturnType<ReturnType<typeof crmBackendPlugin>["routes"]>;
+
+/** CRM records compose with the Kanban plugin's existing boards and tasks. */
+declare const crmSchema: _btst_db.DbPlugin;
+
+/** Read every adapter page so searches and counts are not silently truncated. */
+declare function getCrmRows<T>(adapter: DBAdapter, model: string): Promise<T[]>;
+/** Paginate an already filtered CRM collection. */
+declare function crmPage<T>(items: T[], query: {
+    limit: number;
+    offset: number;
+}): {
+    items: T[];
+    total: number;
+};
+declare function getContactRecord(adapter: DBAdapter, id: string): Promise<ContactRecord | null>;
+declare function getCompanyRecord(adapter: DBAdapter, id: string): Promise<CompanyRecord | null>;
+declare function getDealRecord(adapter: DBAdapter, id: string): Promise<DealRecord | null>;
+declare function getActivityRecord(adapter: DBAdapter, id: string): Promise<ActivityRecord | null>;
+/** Find contacts across every stored field, including custom-field values and tags. */
+declare function listContacts(adapter: DBAdapter, query: z.output<typeof listContactsSchema>): Promise<{
+    items: Contact[];
+    total: number;
+}>;
+declare function getContactById(adapter: DBAdapter, id: string): Promise<Contact | null>;
+declare function listCompanies(adapter: DBAdapter, query: z.output<typeof listCompaniesSchema>): Promise<{
+    items: Company[];
+    total: number;
+}>;
+declare function getCompanyById(adapter: DBAdapter, id: string): Promise<Company | null>;
+/** Project authoritative title, stage, and pipeline from the linked Kanban task. */
+declare function hydrateDeal(adapter: DBAdapter, row: DealRecord): Promise<Deal | null>;
+declare function getDealById(adapter: DBAdapter, id: string): Promise<Deal | null>;
+declare function listDeals(adapter: DBAdapter, query: z.output<typeof listDealsSchema>): Promise<{
+    items: Deal[];
+    total: number;
+}>;
+declare function getPipeline(adapter: DBAdapter, id: string): Promise<Pipeline | null>;
+declare function listPipelines(adapter: DBAdapter, query: z.output<typeof paginationSchema>): Promise<{
+    items: Pipeline[];
+    total: number;
+}>;
+declare function listActivities(adapter: DBAdapter, query: z.output<typeof listActivitiesSchema>): Promise<{
+    items: Activity[];
+    total: number;
+}>;
+declare function getContactActivities(adapter: DBAdapter, id: string): Promise<{
+    items: Activity[];
+    total: number;
+}>;
+
+declare function createContact(adapter: DBAdapter, input: DeepReadonly<z.output<typeof createContactSchema>>): Promise<ContactRecord>;
+declare function updateContact(adapter: DBAdapter, id: string, input: DeepReadonly<z.output<typeof updateContactSchema>>): Promise<ContactRecord | null>;
+declare function deleteContact(adapter: DBAdapter, id: string): Promise<void>;
+declare function createCompany(adapter: DBAdapter, input: DeepReadonly<z.output<typeof createCompanySchema>>): Promise<CompanyRecord>;
+declare function updateCompany(adapter: DBAdapter, id: string, input: DeepReadonly<z.output<typeof updateCompanySchema>>): Promise<CompanyRecord | null>;
+declare function deleteCompany(adapter: DBAdapter, id: string): Promise<void>;
+declare function createPipeline(adapter: DBAdapter, input: DeepReadonly<z.output<typeof createPipelineSchema>>): Promise<Pipeline>;
+declare function createDeal(adapter: DBAdapter, input: DeepReadonly<z.output<typeof createDealSchema>>): Promise<DealRecord>;
+declare function updateDeal(adapter: DBAdapter, id: string, taskId: string, input: DeepReadonly<z.output<typeof updateDealSchema>>): Promise<DealRecord | null>;
+declare function moveDeal(adapter: DBAdapter, taskId: string, stage: string, order?: number): Promise<void>;
+declare function deleteDeal(adapter: DBAdapter, id: string, taskId: string): Promise<void>;
+declare function logActivity(adapter: DBAdapter, input: DeepReadonly<z.output<typeof createActivitySchema>>): Promise<ActivityRecord>;
+declare function updateActivity(adapter: DBAdapter, id: string, input: DeepReadonly<z.output<typeof updateActivitySchema>>): Promise<ActivityRecord | null>;
+declare function deleteActivity(adapter: DBAdapter, id: string): Promise<void>;
+
+/** Serialize JSON fields and dates at the API boundary. */
+declare function serializeContact(row: ContactRecord): Contact;
+/** Serialize company dates. */
+declare function serializeCompany(row: CompanyRecord): Company;
+/** Serialize follow-up dates. */
+declare function serializeActivity(row: ActivityRecord): Activity;
+
+export { Activity, Company, Contact, CrmPluginHooks, Deal, Pipeline, createCompany, createContact, createDeal, createPipeline, crmBackendPlugin, crmPage, crmSchema, deleteActivity, deleteCompany, deleteContact, deleteDeal, getActivityRecord, getCompanyById, getCompanyRecord, getContactActivities, getContactById, getContactRecord, getCrmRows, getDealById, getDealRecord, getPipeline, hydrateDeal, listActivities, listCompanies, listContacts, listDeals, listPipelines, logActivity, moveDeal, serializeActivity, serializeCompany, serializeContact, updateActivity, updateCompany, updateContact, updateDeal };
+export type { CrmApiRouter, CrmBackendOptions };