@ecodrix/erix-api 1.3.5 → 1.3.6

package/dist/index.d.ts

@@ -1,3466 +0,0 @@
-import { AxiosInstance, AxiosRequestConfig, Method } from 'axios';
-
-interface RequestOptions extends AxiosRequestConfig {
-    /**
-     * If true, will not add the x-client-code header.
-     */
-    ignoreClientCode?: boolean;
-    /**
-     * Safe execution idempotency key.
-     * If provided, the backend will safely ignore duplicate requests retried with the same key.
-     */
-    idempotencyKey?: string;
-}
-declare abstract class APIResource {
-    protected readonly client: AxiosInstance;
-    constructor(client: AxiosInstance);
-    protected post<T>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-    protected get<T>(url: string, options?: RequestOptions): Promise<T>;
-    protected patch<T>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-    protected put<T>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-    protected deleteRequest<T>(url: string, options?: RequestOptions): Promise<T>;
-    private buildConfig;
-    private handleError;
-}
-
-declare class Agency extends APIResource {
-    /**
-     * List all available blueprints.
-     */
-    listBlueprints<T = any>(): Promise<T>;
-    /**
-     * Create a new blueprint configuration ("Gold Standard").
-     */
-    createBlueprint<T = any>(payload: any): Promise<T>;
-    /**
-     * Deploy a blueprint to a specific tenant client code.
-     */
-    deployBlueprint<T = any>(payload: {
-        clientCode: string;
-        blueprintId: string;
-    }): Promise<T>;
-    /**
-     * Get aggregate portfolio statistics for an agency.
-     */
-    getPortfolioStats<T = any>(agencyCode: string): Promise<T>;
-    /**
-     * Get proactive health report for an agency portfolio.
-     */
-    getPortfolioHealth<T = any>(agencyCode: string): Promise<T>;
-    /**
-     * View consumption usage for a specific client code.
-     */
-    getUsage<T = any>(clientCode: string): Promise<T>;
-    /**
-     * List staff members under a specific agency code.
-     */
-    listStaff<T = any>(agencyCode: string): Promise<T>;
-    /**
-     * Create a new staff member for an agency.
-     */
-    createStaff<T = any>(payload: any): Promise<T>;
-}
-
-interface CheckoutProduct {
-    externalId: string;
-    name: string;
-    price: number;
-    image?: string;
-}
-interface CheckoutAmountBreakdown {
-    subtotal: number;
-    discount: number;
-    delivery: number;
-    total: number;
-}
-interface CheckoutSession {
-    sessionId: string;
-    product: {
-        name: string;
-        price: number;
-        image?: string;
-    };
-    amounts: CheckoutAmountBreakdown;
-    items: Array<{
-        productId: string;
-        quantity: number;
-    }>;
-}
-interface CreateSessionPayload {
-    productId: string;
-    quantity: number;
-    couponCode?: string;
-}
-interface ApplyCouponPayload {
-    sessionId: string;
-    couponCode: string;
-}
-interface VerifyPayload {
-    sessionId: string;
-    method: "truecaller" | "otp";
-    token?: string;
-    phone?: string;
-    otp?: string;
-}
-interface CreateOrderPayload {
-    sessionId: string;
-    customer: {
-        name: string;
-        phone: string;
-        email?: string;
-        address: {
-            line1: string;
-            city: string;
-            state: string;
-            pincode: string;
-        };
-    };
-    paymentProvider: "razorpay" | "cod";
-}
-interface CheckoutOrderResponse {
-    order_id: string;
-    payment_order_id?: string;
-    amount?: number;
-    currency?: string;
-    status?: string;
-    message?: string;
-}
-
-/**
- * Resource for managing the ErixCheckout one-click flow.
- *
- * This resource handles session creation, coupon application,
- * identity verification, and final order placement.
- */
-declare class Checkout extends APIResource {
-    /**
-     * Retrieves product information for the checkout modal.
-     * @param productId - External SKU/ID of the product.
-     */
-    getProduct(productId: string): Promise<CheckoutProduct>;
-    /**
-     * Initializes a new checkout session.
-     */
-    createSession(payload: CreateSessionPayload): Promise<CheckoutSession>;
-    /**
-     * Applies a discount coupon to an active session.
-     */
-    applyCoupon(payload: ApplyCouponPayload): Promise<CheckoutSession>;
-    /**
-     * Verifies user identity via Truecaller or OTP.
-     */
-    verify(payload: VerifyPayload): Promise<{
-        verified: boolean;
-        data?: any;
-    }>;
-    /**
-     * Finalizes the order and initiates payment.
-     */
-    createOrder(payload: CreateOrderPayload): Promise<CheckoutOrderResponse>;
-}
-
-interface CorsOriginCreatePayload {
-    url: string;
-    name?: string;
-    allowedHeaders?: string[];
-    allowedMethods?: string[];
-}
-interface CorsOriginUpdatePayload {
-    url?: string;
-    name?: string;
-    allowedHeaders?: string[];
-    allowedMethods?: string[];
-    isActive?: boolean;
-}
-declare class Cors extends APIResource {
-    /**
-     * List all dynamic cross-origin policies.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Register a new cross-origin client for the SaaS API network dynamically.
-     */
-    create<T = any>(payload: CorsOriginCreatePayload): Promise<T>;
-    /**
-     * Adjust active states or configurations for an existing origin policy.
-     */
-    update<T = any>(id: string, payload: CorsOriginUpdatePayload): Promise<T>;
-    /**
-     * Irreversibly drop support for a cross-origin client URL policy permanently.
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-
-interface LogActivityParams {
-    leadId: string;
-    type: "note" | "call" | "email" | "meeting" | "whatsapp" | "system";
-    title: string;
-    body?: string;
-    metadata?: Record<string, any>;
-}
-interface LogCallParams {
-    durationMinutes: number;
-    summary: string;
-    outcome: "answered" | "no_answer" | "busy" | "voicemail" | "wrong_number";
-}
-declare class Notes extends APIResource {
-    /**
-     * List all notes for a specific lead.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @example
-     * ```typescript
-     * const notes = await erixClient.crm.activities.notes.list("lead_123");
-     * ```
-     */
-    list<T = any>(leadId: string): Promise<T>;
-    /**
-     * Add a new descriptive note to a lead's profile.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @param params - The note content.
-     * @example
-     * ```typescript
-     * await erixClient.crm.activities.notes.create("lead_123", {
-     *   content: "Customer is interested in the enterprise plan."
-     * });
-     * ```
-     */
-    create<T = any>(leadId: string, params: {
-        content: string;
-    }): Promise<T>;
-    /**
-     * Update an existing note.
-     */
-    update<T = any>(noteId: string, content: string): Promise<T>;
-    /**
-     * Pin or unpin a note to the top of the feed.
-     */
-    pin<T = any>(noteId: string, isPinned?: boolean): Promise<T>;
-    /**
-     * Delete a note.
-     */
-    delete(noteId: string): Promise<unknown>;
-}
-declare class Activities extends APIResource {
-    notes: Notes;
-    constructor(client: any);
-    /**
-     * Retrieve the complete chronological timeline of all activities for a lead.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @param params - Optional pagination parameters.
-     * @example
-     * ```typescript
-     * const timeline = await erixClient.crm.activities.timeline("lead_123", { limit: 10 });
-     * ```
-     */
-    timeline<T = any>(leadId: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<T>;
-    /**
-     * List specific activities (filtered by type).
-     */
-    list<T = any>(leadId: string, params?: {
-        type?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<T>;
-    /**
-     * Generic method to log a business activity/event (e.g., system events, manual tasks).
-     *
-     * @param params - Activity details (leadId, type, title, body).
-     * @example
-     * ```typescript
-     * await erixClient.crm.activities.log({
-     *   leadId: "lead_123",
-     *   type: "system",
-     *   title: "Meeting Scheduled",
-     *   body: "Initial consultation booked for Friday."
-     * });
-     * ```
-     */
-    log<T = any>(params: LogActivityParams): Promise<T>;
-    /**
-     * Specific method to log communication outcomes.
-     */
-    logCall<T = any>(leadId: string, params: LogCallParams): Promise<T>;
-}
-
-type AnalyticsRange = "24h" | "7d" | "30d" | "60d" | "90d" | "365d";
-interface AnalyticsParams {
-    range?: AnalyticsRange;
-    from?: string;
-    to?: string;
-    pipelineId?: string;
-}
-declare class Analytics extends APIResource {
-    /**
-     * Retrieve high-level CRM performance KPIs.
-     * Includes total leads, pipeline value, won revenue, and conversion rates.
-     *
-     * @param params - Optional filters including time range (24h, 7d, 30d, etc.) and custom date bounds.
-     * @returns {Promise<any>} KPI summary object containing core business metrics.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.crm.analytics.overview({ range: "30d" });
-     * console.log(stats.avgScore);
-     * ```
-     */
-    overview<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Get stage-by-stage lead counts and conversion percentages for a pipeline.
-     * Useful for identifying funnel bottlenecks and drop-off points.
-     *
-     * @param pipelineId - The unique ID of the pipeline to analyze.
-     * @returns {Promise<any>} Array of funnel stages with count and conversion data.
-     * @example
-     * ```typescript
-     * const funnel = await erixClient.crm.analytics.funnel("pipe_123");
-     * ```
-     */
-    funnel<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Revenue forecast: Calculates expected revenue based on deal value × stage probability.
-     * Helps in sales planning and goal setting.
-     *
-     * @param pipelineId - Optional pipeline ID to filter the forecast.
-     * @returns {Promise<any>} Forecast data including weighted expected revenue.
-     * @example
-     * ```typescript
-     * const prognosis = await erixClient.crm.analytics.forecast("pipe_123");
-     * ```
-     */
-    forecast<T = any>(pipelineId?: string): Promise<T>;
-    /**
-     * Lead source breakdown: count, conversion rate, and total value per source.
-     *
-     * @param params - Time range filters.
-     * @returns {Promise<any>} Breakdown of how different marketing channels are performing.
-     */
-    sources<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Team leaderboard: Evaluates agent performance across won deals, revenue, and activity.
-     *
-     * @param params - Time range filters.
-     * @returns {Promise<any>} Ranked list of team members by performance.
-     */
-    team<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Activity heatmap: Daily activity counts by type.
-     * Ideal for visualizing engagement patterns on a calendar view.
-     *
-     * @param params - Time range filters.
-     * @returns {Promise<any>} Time-series data of team activities.
-     */
-    heatmap<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Score distribution: Groups leads into buckets based on their calculated score (0-100).
-     *
-     * @returns {Promise<any>} Volume of leads in different readiness tiers.
-     */
-    scores<T = any>(): Promise<T>;
-    /**
-     * Avg time in stage: Measures the velocity of leads through the sales pipeline.
-     *
-     * @param pipelineId - Target pipeline ID.
-     * @returns {Promise<any>} Velocity metrics per stage.
-     */
-    stageTime<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Tiered Growth Report matching business sophistication (Pulse, Growth, Weapon).
-     * Provides deep tactical and strategic insights.
-     *
-     * @param params - Filtering and range parameters.
-     */
-    tiered<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Consolidated analytics including CRM overview and WhatsApp messaging metrics.
-     *
-     * @param params - Time range filters.
-     * @returns {Promise<any>} Consolidated analytics object containing CRM overview and WhatsApp messaging metrics.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.crm.analytics.summary({ range: "30d" });
-     * console.log(stats.overview.totalLeads);
-     * ```
-     */
-    summary<T = any>(params?: AnalyticsParams): Promise<T>;
-    /**
-     * Retrieve WhatsApp messaging volume and delivery performance analytics.
-     * Includes total sent, delivered, read, and daily volume trends.
-     *
-     * @param params - Optional filters (time range).
-     * @example
-     * ```typescript
-     * const waStats = await erixClient.crm.analytics.whatsapp({ range: "7d" });
-     * console.log(waStats.totalSent);
-     * ```
-     */
-    whatsapp<T = any>(params?: AnalyticsParams): Promise<T>;
-}
-
-declare class AutomationDashboard extends APIResource {
-    /**
-     * Retrieve summary statistics for automation health (total, success, failed).
-     *
-     * @returns Stats object.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.crm.automationDashboard.stats();
-     * ```
-     */
-    stats<T = any>(): Promise<T>;
-    /**
-     * List recent EventLog entries representing automation executions.
-     *
-     * @param params - Optional filters (limit, status).
-     * @example
-     * ```typescript
-     * const logs = await erixClient.crm.automationDashboard.logs({ status: "failed" });
-     * ```
-     */
-    logs<T = any>(params?: {
-        limit?: number;
-        status?: string;
-    }): Promise<T>;
-    /**
-     * Re-emit a failed event log to re-trigger its associated automation rules.
-     *
-     * @param logId - The unique ID of the failed event log.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automationDashboard.retryFailedEvent("log_123");
-     * ```
-     */
-    retryFailedEvent<T = any>(logId: string): Promise<T>;
-}
-
-interface AutomationRulePayload {
-    name: string;
-    trigger: string;
-    isActive?: boolean;
-    nodes: any[];
-    edges: any[];
-}
-declare class Automations extends APIResource {
-    /**
-     * List all automation rules (workflows) configured for the tenant.
-     *
-     * @returns Array of automation rule objects.
-     * @example
-     * ```typescript
-     * const rules = await erixClient.crm.automations.list();
-     * ```
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Create a new automation rule with triggers and workflow nodes.
-     *
-     * @param payload - The automation rule definition (trigger, nodes, edges).
-     * @returns The created automation rule.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automations.create({
-     *   name: "Welcome Email Workflow",
-     *   trigger: "contact_created",
-     *   nodes: [...],
-     *   edges: [...]
-     * });
-     * ```
-     */
-    create<T = any>(payload: AutomationRulePayload): Promise<T>;
-    /**
-     * Update an existing automation rule.
-     */
-    update<T = any>(ruleId: string, payload: Partial<AutomationRulePayload>): Promise<T>;
-    /**
-     * Enable or disable an automation rule.
-     */
-    toggle<T = any>(ruleId: string): Promise<T>;
-    /**
-     * Delete an automation rule.
-     */
-    delete<T = any>(ruleId: string): Promise<unknown>;
-    /**
-     * Bulk delete rules.
-     */
-    bulkDelete<T = any>(ruleIds: string[]): Promise<T>;
-    /**
-     * Dry-run test an automation rule against a specific lead to verify logic.
-     *
-     * @param ruleId - The ID of the rule to test.
-     * @param leadId - The ID of the lead to run the test against.
-     * @example
-     * ```typescript
-     * await erixClient.crm.automations.test("rule_123", "lead_456");
-     * ```
-     */
-    test<T = any>(ruleId: string, leadId: string): Promise<T>;
-    /**
-     * Get available event triggers for automations.
-     */
-    getAvailableEvents<T = any>(): Promise<T>;
-    /**
-     * List enrollments for a rule.
-     */
-    enrollments<T = any>(ruleId: string, params?: {
-        status?: string;
-        page?: number;
-        limit?: number;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<T>;
-    /**
-     * Get an enrollment detail.
-     */
-    getEnrollment<T = any>(enrollmentId: string): Promise<T>;
-    /**
-     * Pause an enrollment.
-     */
-    pauseEnrollment<T = any>(ruleId: string, enrollmentId: string): Promise<T>;
-    /**
-     * Resume an enrollment.
-     */
-    resumeEnrollment<T = any>(ruleId: string, enrollmentId: string): Promise<T>;
-    /**
-     * List workflow runs.
-     */
-    runs<T = any>(ruleId: string): Promise<T>;
-    /**
-     * Get run details.
-     */
-    getRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Resume a paused run.
-     */
-    resumeRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Abort a running workflow.
-     */
-    abortRun<T = any>(runId: string): Promise<T>;
-    /**
-     * Emit an external webhook event to unlock a `wait_event` node inside a
-     * paused workflow run. Required when integrating third-party tools that
-     * need to resume a suspended automation.
-     *
-     * @param ruleId - The automation rule that contains the wait_event node.
-     * @param eventName - The event name that should match the node's condition.
-     * @param payload - Arbitrary data forwarded to the node context.
-     */
-    webhookEvent<T = any>(ruleId: string, eventName: string, payload?: any): Promise<T>;
-    /**
-     * Fire a CRM automation trigger for a given phone number.
-     *
-     * @param params - Trigger payload (trigger name, phone, variables, etc.)
-     */
-    trigger<T = any>(params: {
-        trigger: string;
-        phone: string;
-        email?: string;
-        variables?: Record<string, string>;
-        createLeadIfMissing?: boolean;
-        leadData?: any;
-        delayMinutes?: number;
-        runAt?: Date | string;
-    }): Promise<T>;
-}
-
-/**
- * The specific UI control type suggested for a field.
- */
-type FieldType = "string" | "number" | "boolean" | "date" | "datetime" | "select" | "multi-select" | "phone" | "email" | "currency" | "json" | "textarea" | "richtext" | "file" | "image";
-/**
- * Metadata defining a single field within a resource.
- * Used by UI kits to automatically generate forms and validation logic.
- */
-interface FieldManifest {
-    /** The technical key name used in API requests. */
-    key: string;
-    /** Human-readable label (localized if possible). */
-    label: string;
-    /** Suggested UI type. */
-    type: FieldType;
-    /** Short hint/placeholder text. */
-    description?: string;
-    /** Whether the field is required for creation. */
-    required: boolean;
-    /** Whether the field should be hidden from standard create/edit forms. */
-    hidden?: boolean;
-    /** If type is 'select', the available options. */
-    options?: Array<{
-        label: string;
-        value: string | number;
-    }>;
-    /** Validation constraints. */
-    validation?: {
-        regex?: string;
-        min?: number;
-        max?: number;
-        message?: string;
-    };
-    /** Whether the field is read-only. */
-    readOnly?: boolean;
-    /** UI grouping/category name. */
-    group?: string;
-}
-/**
- * A logical grouping of fields and UI hints for a top-level resource.
- * Provides a 'blueprint' for erix-react components.
- */
-interface ResourceManifest {
-    /** The unique name of the resource (e.g., 'Lead', 'Template'). */
-    name: string;
-    /** All available fields for this resource. */
-    fields: FieldManifest[];
-    /** Suggested UI configurations. */
-    uiHints?: {
-        icon?: string;
-        primaryColor?: string;
-        /** Default sort order. */
-        defaultSort?: {
-            field: string;
-            direction: "asc" | "desc";
-        };
-        /** Fields to show in a compact table view. */
-        summaryFields?: string[];
-    };
-}
-
-/**
- * Valid statuses for a CRM Lead.
- */
-type LeadStatus = "new" | "contacted" | "qualified" | "won" | "lost" | "archived";
-/**
- * Common lead acquisition sources. Additional string values are allowed.
- */
-type LeadSource = "website" | "whatsapp" | "direct" | "referral" | string;
-/**
- * Parameters for creating a new CRM Lead.
- */
-interface CreateLeadParams {
-    /** Lead's full name (alternative to firstName/lastName). */
-    name?: string;
-    /** Lead's first name. Required for creation if name is not provided. */
-    firstName?: string;
-    /** Lead's last name. */
-    lastName?: string;
-    /** Lead's email address. */
-    email?: string;
-    /** Lead's phone number in E.164 format (e.g. "+919876543210"). */
-    phone?: string;
-    /**
-     * Current status of the lead.
-     */
-    status?: LeadStatus;
-    /**
-     * Estimated value of the lead.
-     */
-    value?: number;
-    /**
-     * Acquisition channel.
-     */
-    source?: LeadSource;
-    /** Primary message or enquiry from the lead. */
-    message?: string;
-    /** Internal note about the lead activity. */
-    activityNote?: string;
-    /** Arbitrary key-value metadata (UTM params, order IDs, etc.). */
-    metadata?: Record<string, any>;
-    /** Pipeline ID to assign the lead */
-    pipelineId?: string;
-    /** Stage ID to assign the lead */
-    stageId?: string;
-}
-/**
- * Options for listing leads.
- */
-interface ListLeadsParams {
-    status?: LeadStatus;
-    pipelineId?: string;
-    stageId?: string;
-    source?: LeadSource;
-    assignedTo?: string;
-    tags?: string[] | string;
-    minScore?: number;
-    search?: string;
-    startDate?: string;
-    endDate?: string;
-    appointmentId?: string;
-    bookingId?: string;
-    orderId?: string;
-    meetingId?: string;
-    page?: number;
-    limit?: number;
-    sortBy?: string;
-    sortDir?: "asc" | "desc";
-}
-/**
- * Options for upserting a lead.
- */
-interface UpsertLeadParams {
-    leadData: Partial<CreateLeadParams> & {
-        phone: string;
-        name?: string;
-    };
-    moduleInfo?: any;
-    trigger?: string;
-    pipelineId?: string;
-    stageId?: string;
-}
-/**
- * CRM Lead resource — full lifecycle management.
- *
- * Access via `ecod.crm.leads`.
- *
- * @example
- * ```typescript
- * const { data: lead } = await ecod.crm.leads.create({
- *   firstName: "Alice",
- *   phone: "+919876543210",
- *   source: "website",
- * });
- * ```
- */
-declare class Leads extends APIResource {
-    /**
-     * Create a new lead in the CRM pipeline.
-     *
-     * @param params - Lead creation parameters. `firstName` is required.
-     * @returns The newly created Lead document.
-     * @example
-     * ```typescript
-     * const lead = await erixClient.crm.leads.create({
-     *   firstName: "Alice",
-     *   phone: "+919876543210",
-     *   source: "website"
-     * });
-     * ```
-     */
-    create<T = any>(params: CreateLeadParams): Promise<T>;
-    /**
-     * Introspect the Leads resource and provide a "Blueprint" for UI generation.
-     *
-     * This method returns a list of all fields (standard + custom), their types,
-     * labels, and suggested UI controls. Erix React uses this to render SmartForms
-     * and tables dynamically.
-     */
-    describe(): Promise<ResourceManifest>;
-    /**
-     * Upsert a lead by phone number. If a lead with the same phone exists,
-     * it will be updated; otherwise, a new lead is created.
-     *
-     * @param params - Upsert parameters containing leadData with a phone number.
-     * @returns The newly created or updated Lead document.
-     * @example
-     * ```typescript
-     * await erixClient.crm.leads.upsert({
-     *   leadData: { phone: "+919876543210", firstName: "Alice" }
-     * });
-     * ```
-     */
-    upsert<T = any>(params: UpsertLeadParams): Promise<T>;
-    /**
-     * Bulk ingest leads efficiently in parallel using automatic chunking.
-     * Prevents rate limit exhaustion by executing `chunkSize` requests at a time.
-     *
-     * @param leads - Array of leads to create.
-     * @param chunkSize - Number of leads to send concurrently (default: 50)
-     * @returns Array of created lead results.
-     */
-    createMany(leads: CreateLeadParams[], chunkSize?: number): Promise<any[]>;
-    /**
-     * Bulk upsert (import) leads. Supports high-volume synchronization.
-     *
-     * @param leads - Array of leads to import.
-     * ---- **Done** ---- API Endpoint
-     */
-    import<T = any>(leads: Partial<CreateLeadParams>[]): Promise<T>;
-    /**
-     * Alias for bulk upserting leads.
-     *
-     * @param leads - Array of leads to import.
-     * ---- **Done** ---- API Endpoint
-     */
-    bulkUpsert<T = any>(leads: Partial<CreateLeadParams>[]): Promise<T>;
-    /**
-     * List CRM leads with optional filtering and pagination.
-     *
-     * @param params - Filter options (status, source, pipelineId, page, limit, etc.)
-     * @returns Paginated list of Lead documents.
-     * @example
-     * ```typescript
-     * const leads = await erixClient.crm.leads.list({
-     *   status: "new",
-     *   source: "website",
-     *   limit: 20
-     * });
-     * ```
-     */
-    list<T = any>(params?: ListLeadsParams): Promise<T>;
-    /**
-     * Auto-paginating iterator for leads.
-     * Seamlessly fetches leads page by page as you iterate.
-     *
-     * @example
-     * ```typescript
-     * for await (const lead of ecod.crm.leads.listAutoPaging<Lead>()) {
-     *   console.log(lead.firstName);
-     * }
-     * ```
-     */
-    listAutoPaging<T = any>(params?: ListLeadsParams): AsyncGenerator<T, void, unknown>;
-    /**
-     * Retrieve a single lead by its unique ID.
-     *
-     * @param leadId - The MongoDB ObjectId of the lead.
-     * @returns The Lead document, or a 404 error if not found.
-     * @example
-     * ```typescript
-     * const lead = await erixClient.crm.leads.retrieve("64abc...");
-     * ```
-     */
-    retrieve<T = any>(leadId: string): Promise<T>;
-    /**
-     * Retrieve a single lead by its phone number.
-     *
-     * @param phone - Lead's phone number.
-     * ---- **Done** ---- API Endpoint
-     */
-    retrieveByPhone<T = any>(phone: string): Promise<T>;
-    /**
-     * Fetches all leads belonging to a specific Kanban column in a pipeline.
-     *
-     * @param pipelineId - Parent pipeline ID.
-     * @param stageId - Target stage ID.
-     * @param params - Pagination controls.
-     * @returns Paginated result set.
-     * ---- **Done** ---- API Endpoint
-     */
-    byStage<T = any>(pipelineId: string, stageId: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<T>;
-    /**
-     * Retrieve a single lead by a reference key and value.
-     *
-     * @param refKey - Reference key metadata.
-     * @param refValue - Reference value.
-     */
-    retrieveByRef<T = any>(refKey: string, refValue: string): Promise<T>;
-    /**
-     * Update the fields of an existing lead.
-     *
-     * @param leadId - The ID of the lead to update.
-     * @param params - Partial lead fields to update.
-     * @returns The updated Lead document.
-     * @example
-     * ```typescript
-     * await erixClient.crm.leads.update("64abc...", {
-     *   lastName: "Smith",
-     *   status: "qualified"
-     * });
-     * ```
-     */
-    update<T = any>(leadId: string, params: Partial<CreateLeadParams>): Promise<T>;
-    /**
-     * Move a lead to a new stage in a pipeline.
-     *
-     * @param leadId - ID of the lead.
-     * @param stageId - Target stage ID.
-     */
-    move<T = any>(leadId: string, stageId: string): Promise<T>;
-    /**
-     * Convert a lead (mark as won or lost with reason).
-     *
-     * @param leadId - ID of the lead.
-     * @param outcome - "won" | "lost"
-     * @param reason - Reason for the outcome.
-     */
-    convert<T = any>(leadId: string, outcome: "won" | "lost", reason?: string): Promise<T>;
-    /**
-     * Update the tags of a lead.
-     *
-     * @param leadId - ID of the lead.
-     * @param options - Tags to add or remove.
-     */
-    tags<T = any>(leadId: string, options: {
-        add?: string[];
-        remove?: string[];
-    }): Promise<T>;
-    /**
-     * Recalculate lead score based on activities and interactions.
-     *
-     * @param leadId - ID of the lead.
-     */
-    recalculateScore<T = any>(leadId: string): Promise<T>;
-    /**
-     * Update embedded metadata/references of a lead without touching core fields.
-     *
-     * @param leadId - ID of the lead.
-     * @param metadata - Metadata object indicating { refs, extra }
-     */
-    updateMetadata<T = any>(leadId: string, metadata: {
-        refs?: Record<string, any>;
-        extra?: Record<string, any>;
-    }): Promise<T>;
-    /**
-     * Introspect available custom fields configured by the tenant limit.
-     */
-    fields<T = any>(): Promise<T>;
-    /**
-     * List all notes for a specific lead.
-     */
-    notes<T = any>(leadId: string): Promise<T>;
-    /**
-     * Retrieve the complete chronological timeline for a lead.
-     */
-    activities<T = any>(leadId: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<T>;
-    /**
-     * Add a note to a lead.
-     */
-    createNote<T = any>(leadId: string, params: {
-        content: string;
-    }): Promise<T>;
-    /**
-     * Update an existing note.
-     */
-    updateNote<T = any>(leadId: string, noteId: string, params: {
-        content: string;
-    }): Promise<T>;
-    /**
-     * Delete a note.
-     */
-    deleteNote<T = any>(leadId: string, noteId: string): Promise<unknown>;
-    /**
-     * Delete a single lead permanently.
-     *
-     * @param leadId - The ID of the lead to delete.
-     * ---- **Done** ---- API Endpoint
-     */
-    delete(leadId: string): Promise<unknown>;
-    /**
-     * Bulk archive multiple leads.
-     *
-     * @param ids - Array of lead IDs to archive.
-     * ---- **Done** ---- API Endpoint
-     */
-    bulkArchive<T = any>(ids: string[]): Promise<T>;
-    /**
-     * Bulk delete multiple leads permanently.
-     *
-     * @param ids - Array of lead IDs to archive.
-     * ---- **Done** ---- API Endpoint
-     */
-    bulkDelete(ids: string[]): Promise<unknown>;
-    /**
-     * Archive a single lead.
-     *
-     * @param leadId - The ID of the lead to archive.
-     */
-    archive<T = any>(leadId: string): Promise<T>;
-}
-
-declare class Payments extends APIResource {
-    /**
-     * Record an inbound payment/transaction against a lead or specific appointment.
-     *
-     * @param payload - Payment details (leadId, amount, currency, description).
-     * @example
-     * ```typescript
-     * await erixClient.crm.payments.capture({
-     *   leadId: "lead_123",
-     *   amount: 5000,
-     *   currency: "INR",
-     *   description: "Consultation Fee"
-     * });
-     * ```
-     */
-    capture<T = any>(payload: {
-        leadId: string;
-        amount: number;
-        currency?: string;
-        description?: string;
-        appointmentId?: string;
-    }): Promise<T>;
-}
-
-interface PipelineStageParams {
-    name: string;
-    color?: string;
-    probability?: number;
-    isWon?: boolean;
-    isLost?: boolean;
-}
-declare class Pipelines extends APIResource {
-    /**
-     * List all CRM pipelines and their configured stages.
-     *
-     * @returns Array of pipeline objects with nested stages.
-     * @example
-     * ```typescript
-     * const pipelines = await erixClient.crm.pipelines.list();
-     * ```
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Introspect a pipeline and provide a manifest of its stages.
-     *
-     * Returns metadata about stage colors, probabilities, and order.
-     * Erix React uses this to build kanban boards and stage pickers.
-     *
-     * @param pipelineId - The unique ID of the pipeline.
-     */
-    getStageManifest(pipelineId: string): Promise<ResourceManifest>;
-    /**
-     * Create a new CRM sales or support pipeline.
-     *
-     * @param payload - Pipeline details (name and array of stage names).
-     * @returns The created pipeline record.
-     * @example
-     * ```typescript
-     * await erixClient.crm.pipelines.create({
-     *   name: "Sales Pipeline",
-     *   stages: ["Lead", "Contacted", "Proposal", "Negotiation", "Closed"]
-     * });
-     * ```
-     */
-    create<T = any>(payload: {
-        name: string;
-        stages: string[];
-    }): Promise<T>;
-    /**
-     * Retrieve a single pipeline configuration by ID.
-     *
-     * @param pipelineId - The unique ID of the pipeline.
-     * @example
-     * ```typescript
-     * const pipeline = await erixClient.crm.pipelines.retrieve("pipe_123");
-     * ```
-     */
-    retrieve<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Update an existing pipeline.
-     */
-    update<T = any>(pipelineId: string, payload: Partial<{
-        name: string;
-        stages: string[];
-    }>): Promise<T>;
-    /**
-     * Set pipeline as the tenant's default.
-     */
-    setDefault<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Duplicate a pipeline with a new name.
-     */
-    duplicate<T = any>(pipelineId: string, newName: string): Promise<T>;
-    /**
-     * Archive a pipeline.
-     */
-    archive<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Delete a pipeline permanently.
-     */
-    delete(pipelineId: string): Promise<unknown>;
-    /**
-     * Check if a pipeline is in use (e.g. has leads attached).
-     */
-    checkInUse<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Retrieve a Kanban-style board representation of the pipeline with leads nested.
-     *
-     * @param pipelineId - The unique ID of the pipeline.
-     * @example
-     * ```typescript
-     * const board = await erixClient.crm.pipelines.board("pipe_123");
-     * ```
-     */
-    board<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Retrieve a revenue forecast based on stage probabilities for a pipeline.
-     */
-    forecast<T = any>(pipelineId: string): Promise<T>;
-    /**
-     * Add a new stage to the pipeline.
-     *
-     * @param pipelineId - The unique ID of the pipeline.
-     * @param params - Stage details (name, color, probability).
-     * @example
-     * ```typescript
-     * await erixClient.crm.pipelines.addStage("pipe_123", {
-     *   name: "Decision Maker Bought In",
-     *   color: "#FF5733",
-     *   probability: 80
-     * });
-     * ```
-     */
-    addStage<T = any>(pipelineId: string, params: PipelineStageParams): Promise<T>;
-    /**
-     * Change the order of stages inside the pipeline.
-     */
-    reorderStages<T = any>(pipelineId: string, orderArray: string[]): Promise<T>;
-    /**
-     * Update a specific stage.
-     */
-    updateStage<T = any>(stageId: string, params: Partial<PipelineStageParams>): Promise<T>;
-    /**
-     * Delete a stage permanently.
-     *
-     * @param stageId - The unique ID of the stage to delete.
-     * @param moveLeadsToStageId - Optional fallback stageId to move active leads to before deletion.
-     */
-    deleteStage(stageId: string, moveLeadsToStageId?: string): Promise<unknown>;
-}
-
-interface ScoringConfig {
-    /** Scoring rules — each rule adds/subtracts points based on field conditions. */
-    rules: any[];
-    /**
-     * Score threshold above which a lead is considered "hot".
-     * @default 70
-     */
-    hotThreshold?: number;
-    /**
-     * Score threshold below which a lead is considered "cold".
-     * @default 20
-     */
-    coldThreshold?: number;
-    /**
-     * List of CRM trigger names that cause an automatic score recalculation.
-     * @example ["lead_created", "appointment_booked"]
-     */
-    recalculateOnTriggers?: string[];
-}
-declare class Scoring extends APIResource {
-    /**
-     * Retrieve the tenant's global lead scoring configuration (rules, decay, thresholds).
-     *
-     * @returns The scoring configuration object.
-     * @example
-     * ```typescript
-     * const config = await erixClient.crm.scoring.getConfig();
-     * ```
-     */
-    getConfig<T = any>(): Promise<T>;
-    /**
-     * Update scoring configuration.
-     */
-    updateConfig<T = any>(payload: Partial<ScoringConfig>): Promise<T>;
-    /**
-     * Force an immediate score recalculation for a specific lead.
-     * Useful when profile data changes significantly.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @example
-     * ```typescript
-     * await erixClient.crm.scoring.recalculate("lead_123");
-     * ```
-     */
-    recalculate<T = any>(leadId: string): Promise<T>;
-}
-
-declare class Sequences extends APIResource {
-    /**
-     * Manually enroll a lead into a specific automation drip sequence (Workflow).
-     *
-     * @param payload - Enrollment details (leadId, ruleId, and custom variables).
-     * @example
-     * ```typescript
-     * await erixClient.crm.sequences.enroll({
-     *   leadId: "lead_123",
-     *   ruleId: "rule_456",
-     *   variables: { start_date: "2026-05-01" }
-     * });
-     * ```
-     */
-    enroll<T = any>(payload: {
-        leadId: string;
-        ruleId: string;
-        variables?: Record<string, any>;
-    }): Promise<T>;
-    /**
-     * Unenroll a lead from a currently running automation sequence.
-     *
-     * @param enrollmentId - The unique ID of the sequence enrollment.
-     * @example
-     * ```typescript
-     * await erixClient.crm.sequences.unenroll("enroll_123");
-     * ```
-     */
-    unenroll<T = any>(enrollmentId: string): Promise<unknown>;
-    /**
-     * List all active and completed sequence enrollments for a specific lead.
-     *
-     * @param leadId - The unique ID of the lead.
-     * @returns Array of enrollment records.
-     * @example
-     * ```typescript
-     * const enrollments = await erixClient.crm.sequences.listForLead("lead_123");
-     * ```
-     */
-    listForLead<T = any>(leadId: string): Promise<T>;
-}
-
-declare class CRM {
-    leads: Leads;
-    pipelines: Pipelines;
-    activities: Activities;
-    analytics: Analytics;
-    automations: Automations;
-    sequences: Sequences;
-    scoring: Scoring;
-    payments: Payments;
-    automationDashboard: AutomationDashboard;
-    constructor(client: AxiosInstance);
-}
-
-/**
- * Payload to send a high-throughput email campaign.
- */
-interface SendCampaignPayload {
-    /** Array of recipient email addresses. */
-    recipients: string[];
-    /** Subject line of the email. */
-    subject: string;
-    /** HTML body of the email. */
-    html: string;
-}
-/**
- * Interface representing the result of a campaign dispatch.
- */
-interface CampaignResult {
-    /** Indicates if the campaign was successfully queued/sent. */
-    success: boolean;
-    /** Optional message detailing the result. */
-    message?: string;
-    /** Additional dynamic properties. */
-    [key: string]: any;
-}
-/**
- * Represents an email template within the system.
- */
-interface EmailTemplate {
-    /** Unique identifier of the template. */
-    id: string;
-    /** Human-readable name of the template. */
-    name: string;
-    /** Optional description explaining the template's purpose. */
-    description?: string;
-    /** Subject line used when sending emails with this template. */
-    subject: string;
-    /** Optional preheader text (hidden snippet visible in email clients). */
-    preheader?: string;
-    /** Raw HTML content of the template. */
-    htmlBody: string;
-    /** Optional plain-text fallback content. */
-    textBody?: string;
-    /** Broad category classification for the template. */
-    category: "marketing" | "transactional" | "sequence";
-    /** Current state of the template. */
-    status: "draft" | "published" | "archived";
-    /** Type of template, whether standard or a reusable layout. */
-    type: "standard" | "layout";
-    /** Optional layout ID if this template inherits from a layout. */
-    layoutId?: string;
-    /** Optional URL to a thumbnail image representing the template. */
-    thumbnail?: string;
-    /** Array defining dynamic variables used within the template. */
-    variableMapping?: any[];
-    /** ISO timestamp of when the template was created. */
-    createdAt: string;
-    /** ISO timestamp of when the template was last updated. */
-    updatedAt: string;
-}
-/**
- * Data transfer object for creating a new email template.
- */
-interface CreateTemplateDTO {
-    /** Name of the template. */
-    name: string;
-    /** Email subject line. */
-    subject: string;
-    /** Raw HTML content. */
-    htmlBody: string;
-    /** Optional description. */
-    description?: string;
-    /** Category of the template. Defaults to marketing if not provided. */
-    category?: "marketing" | "transactional" | "sequence";
-    /** Initial status. Defaults to draft. */
-    status?: "draft" | "published" | "archived";
-    /** Optional variable mapping definitions. */
-    variableMapping?: any[];
-}
-/**
- * Response structure when previewing an email template.
- */
-interface TemplatePreviewResponse {
-    /** Indicates if the preview generation was successful. */
-    success: boolean;
-    /** The generated preview content. */
-    data: {
-        /** Resolved subject line. */
-        subject: string;
-        /** Resolved HTML body. */
-        html: string;
-        /** Resolved plain text fallback (if available). */
-        text?: string;
-    };
-}
-/**
- * Outbound email marketing engine and template management.
- *
- * Access via `ecod.email`.
- */
-declare class Email extends APIResource {
-    /**
-     * Send an HTML email campaign to a list of recipients.
-     *
-     * @param payload - Data required to send a campaign.
-     * @returns A promise resolving to the campaign result.
-     * @example
-     * ```typescript
-     * await erixClient.email.sendCampaign({
-     *   recipients: ["test@example.com"],
-     *   subject: "Hello!",
-     *   html: "<h1>Hi there</h1>"
-     * });
-     * ```
-     */
-    sendCampaign(payload: SendCampaignPayload): Promise<CampaignResult>;
-    /**
-     * Send a system test email to validate your current SMTP configuration.
-     *
-     * @param to - The recipient email address for the test email.
-     * @returns A promise resolving to the result of the test email dispatch.
-     * @example
-     * ```typescript
-     * await erixClient.email.sendTest("admin@mycompany.com");
-     * ```
-     */
-    sendTest(to: string): Promise<CampaignResult>;
-    /**
-     * List all email templates.
-     *
-     * @param query - Optional query parameters for filtering and pagination.
-     * @returns A promise resolving to a paginated or filtered list of templates.
-     * @example
-     * ```typescript
-     * const response = await erixClient.email.listTemplates({ category: "marketing" });
-     * console.log(response.data);
-     * ```
-     */
-    listTemplates(query?: any): Promise<{
-        success: boolean;
-        data: EmailTemplate[];
-    }>;
-    /**
-     * Get a single email template by ID.
-     *
-     * @param id - The unique identifier of the template.
-     * @returns A promise resolving to the requested template details.
-     * @example
-     * ```typescript
-     * const template = await erixClient.email.getTemplate("tpl_123abc");
-     * ```
-     */
-    getTemplate(id: string): Promise<{
-        success: boolean;
-        data: EmailTemplate;
-    }>;
-    /**
-     * Create a new email template.
-     *
-     * @param data - The template data transfer object containing the details.
-     * @returns A promise resolving to the newly created template.
-     * @example
-     * ```typescript
-     * const newTpl = await erixClient.email.createTemplate({
-     *   name: "Welcome Series 1",
-     *   subject: "Welcome to our platform!",
-     *   htmlBody: "<h1>Welcome</h1><p>We are glad you are here.</p>"
-     * });
-     * ```
-     */
-    createTemplate(data: CreateTemplateDTO): Promise<{
-        success: boolean;
-        data: EmailTemplate;
-    }>;
-    /**
-     * Update an existing email template.
-     *
-     * @param id - The unique identifier of the template to update.
-     * @param data - The partial data transfer object to update the template with.
-     * @returns A promise resolving to the updated template.
-     * @example
-     * ```typescript
-     * await erixClient.email.updateTemplate("tpl_123abc", {
-     *   subject: "Updated Welcome Subject"
-     * });
-     * ```
-     */
-    updateTemplate(id: string, data: Partial<CreateTemplateDTO>): Promise<{
-        success: boolean;
-        data: EmailTemplate;
-    }>;
-    /**
-     * Delete an email template.
-     *
-     * @param id - The unique identifier of the template to delete.
-     * @param force - Optional flag to force deletion even if the template is in use (default: false).
-     * @returns A promise resolving to a success indicator.
-     * @example
-     * ```typescript
-     * await erixClient.email.deleteTemplate("tpl_123abc");
-     * ```
-     */
-    deleteTemplate(id: string, force?: boolean): Promise<{
-        success: boolean;
-    }>;
-    /**
-     * Preview a template with dynamic variable resolution.
-     * Use this to see how a template renders with specific lead data or custom variables.
-     *
-     * @param id - The unique identifier of the template.
-     * @param params - Parameters containing the lead ID or custom variables to inject.
-     * @returns A promise resolving to the rendered HTML and subject.
-     * @example
-     * ```typescript
-     * const preview = await erixClient.email.previewTemplate("tpl_123abc", {
-     *   variables: { first_name: "Jane" }
-     * });
-     * console.log(preview.data.html);
-     * ```
-     */
-    previewTemplate(id: string, params: {
-        leadId?: string;
-        variables?: Record<string, any>;
-    }): Promise<TemplatePreviewResponse>;
-}
-
-/**
- * Event definition representing an entry point capable of triggering automations.
- */
-interface EventDefinition {
-    name: string;
-    displayName: string;
-    description?: string;
-    pipelineId?: string;
-    stageId?: string;
-    defaultSource?: string;
-    [key: string]: any;
-}
-/**
- * Payload to register/assign a new custom event definition.
- */
-interface AssignEventPayload {
-    /** The internal machine-readable name of the event (e.g. "webinar_joined") */
-    name: string;
-    /** Human-readable display name */
-    displayName: string;
-    /** Event description */
-    description?: string;
-    /** ID of the pipeline to associate with matching leads */
-    pipelineId?: string;
-    /** ID of the stage within the pipeline */
-    stageId?: string;
-    /** Default source tag for leads created via this event */
-    defaultSource?: string;
-}
-/**
- * Payload to programmatically trigger an event/workflow.
- */
-interface TriggerPayload {
-    /** The name of the event to fire (e.g., "webinar_joined") */
-    trigger: string;
-    /** Phone number of the lead (E.164 format) */
-    phone: string;
-    /** Email of the lead */
-    email?: string;
-    /** Key-value pairs for string templates */
-    variables?: Record<string, string>;
-    /** Deep payload data mapping to the event */
-    data?: any;
-    /** URL to receive an acknowledgment callback when processing completes */
-    callbackUrl?: string;
-    /** Secret metadata passed back to the callback URL */
-    callbackMetadata?: any;
-    /** Auto-create lead if phone does not exist in CRM */
-    createLeadIfMissing?: boolean;
-    /** Pre-fill data if creating a new lead */
-    leadData?: {
-        firstName?: string;
-        lastName?: string;
-        source?: string;
-    };
-    /** Delay execution of matched workflows (in seconds) */
-    delaySeconds?: number;
-    /** Delay execution of matched workflows (in minutes) */
-    delayMinutes?: number;
-    /** Explicit ISO timestamp to trigger the workflow run */
-    runAt?: string;
-    /** Automatically generate a Google Meet appointment if matched actions require it */
-    requiresMeet?: boolean;
-    /** Configuration details for the generated Google Meet appointment */
-    meetConfig?: {
-        summary?: string;
-        description?: string;
-        startTime?: string;
-        duration?: number;
-        timezone?: string;
-        attendees?: string[];
-    };
-}
-/**
- * Response returned when triggering an event.
- */
-interface TriggerResponse {
-    success: boolean;
-    data?: {
-        eventLogId: string;
-        trigger: string;
-        leadId: string;
-        rulesMatched: number;
-    };
-    message?: string;
-    code?: string;
-}
-declare class EventsResource extends APIResource {
-    /**
-     * List all available event definitions (both system and custom) that can trigger automations.
-     *
-     * @returns Array of event definitions.
-     * @example
-     * ```typescript
-     * const events = await erixClient.events.list();
-     * ```
-     */
-    list(): Promise<{
-        success: boolean;
-        data: EventDefinition[];
-    }>;
-    /**
-     * Register a new custom event entry point into the CRM automation engine.
-     * Useful when introducing new granular triggers.
-     */
-    assign(payload: AssignEventPayload): Promise<{
-        success: boolean;
-        data: EventDefinition;
-    }>;
-    /**
-     * Deactivate a custom event assignment by name.
-     */
-    unassign(name: string): Promise<{
-        success: boolean;
-        data: any;
-    }>;
-    /**
-     * Deactivate multiple custom event assignments simultaneously.
-     */
-    unassignBulk(names: string[]): Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    /**
-     * Programmatically trigger an automation workflow by firing a specific event.
-     * This matches the event against active Automation Rules and executes linked actions.
-     *
-     * @param payload - The trigger details (event name, lead phone/email, variables).
-     * @returns Trigger response with diagnostic info (eventLogId, matched rules).
-     * @example
-     * ```typescript
-     * await erixClient.events.trigger({
-     *   trigger: "webinar_joined",
-     *   phone: "+919876543210",
-     *   variables: { webinar_name: "AI Masterclass" },
-     *   createLeadIfMissing: true
-     * });
-     * ```
-     */
-    trigger(payload: TriggerPayload): Promise<TriggerResponse>;
-    /**
-     * List all custom event definitions.
-     */
-    listCustomEvents<T = any>(): Promise<T>;
-    /**
-     * Create or upsert a custom event definition.
-     */
-    createCustomEvent<T = any>(payload: {
-        name: string;
-        displayName: string;
-        description?: string;
-    }): Promise<T>;
-    /**
-     * Delete a custom event definition.
-     */
-    deleteCustomEvent<T = any>(id: string): Promise<T>;
-    /**
-     * Manually emit a custom event to trigger workflows based on its definition.
-     */
-    emit<T = any>(payload: {
-        eventName: string;
-        leadId: string;
-        data?: any;
-    }): Promise<T>;
-}
-
-interface SystemHealth {
-    status: string;
-    version: string;
-    env: string;
-    uptime: number;
-    db: string;
-    queueDepth: number;
-    timestamp: string;
-}
-interface ClientHealth {
-    clientCode: string;
-    services: {
-        whatsapp: "connected" | "not_configured";
-        email: "configured" | "not_configured";
-        googleMeet: "configured" | "not_configured";
-    };
-    activeAutomations: number;
-    queueDepth: number;
-    timestamp: string;
-}
-interface JobStatus {
-    jobId: string;
-    status: string;
-    attempts: number;
-    maxAttempts: number;
-    lastError: any;
-    runAt: string;
-    completedAt: string | null;
-    failedAt: string | null;
-    createdAt: string;
-}
-/**
- * Platform and tenant-specific health diagnostics.
- *
- * Access via `ecod.health`.
- */
-declare class Health extends APIResource {
-    /**
-     * Perform a global platform health check.
-     * Verify that the core API, database, and background workers are operational.
-     */
-    system(): Promise<SystemHealth>;
-    /**
-     * Tenant-specific health check.
-     *
-     * Identifies correctly configured third-party integrations (WhatsApp, SMTP, Google Meet)
-     * and reports active automation counts.
-     */
-    clientHealth(): Promise<ClientHealth>;
-    /**
-     * Alias for clientHealth to match diagnostic terminology.
-     */
-    getDiagnosticReport(): Promise<ClientHealth>;
-    /**
-     * Lookup the execution status of a background job.
-     *
-     * Use this to poll for completion of long-running tasks like bulk exports
-     * or campaign dispatches.
-     *
-     * @param jobId - The unique ID of the background job.
-     */
-    jobStatus(jobId: string): Promise<JobStatus>;
-}
-
-interface LogPaginationQuery {
-    page?: number;
-    limit?: number;
-    trigger?: string;
-    status?: "received" | "processing" | "completed" | "partial" | "failed";
-    from?: string;
-    to?: string;
-}
-interface EventLog {
-    id: string;
-    trigger: string;
-    phone?: string;
-    email?: string;
-    status: "received" | "processing" | "completed" | "partial" | "failed";
-    rulesMatched: number;
-    jobsCreated: number;
-    meetLink?: string;
-    callbackUrl?: string;
-    callbackStatus: "not_required" | "sent" | "failed";
-    payload: any;
-    error?: string;
-    idempotencyKey?: string;
-    processedAt?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CallbackLog {
-    id: string;
-    callbackUrl: string;
-    method: string;
-    payload: any;
-    jobId?: string;
-    enrollmentId?: string;
-    responseStatus: number;
-    responseBody: string;
-    status: "sent" | "failed" | "pending_retry";
-    attempts: number;
-    lastAttemptAt?: string;
-    signature?: string;
-    createdAt: string;
-}
-interface LogResponse<T> {
-    success: boolean;
-    data: T[];
-    pagination: {
-        total: number;
-        page: number;
-        limit: number;
-        pages: number;
-    };
-}
-/**
- * Audit and execution logs for platform events and webhooks.
- *
- * Access via `ecod.logs`.
- */
-declare class Logs extends APIResource {
-    /**
-     * List event execution logs with optional filtering.
-     *
-     * Use this to audit automation triggers and debug workflow execution.
-     */
-    listEventLogs(query?: LogPaginationQuery): Promise<LogResponse<EventLog>>;
-    /**
-     * Get detailed information for a single event execution.
-     */
-    getEventLog(id: string): Promise<{
-        success: boolean;
-        data: EventLog;
-    }>;
-    /**
-     * List webhook callback logs (outbound responses from ECODrIx to your system).
-     */
-    listCallbackLogs(query?: LogPaginationQuery): Promise<LogResponse<CallbackLog>>;
-    /**
-     * Get high-level execution statistics for the tenant.
-     */
-    getStats(): Promise<{
-        success: boolean;
-        data: any;
-    }>;
-}
-
-/**
- * Parameters required to send an email campaign.
- */
-interface SendCampaignParams {
-    /** Array of recipient email addresses. */
-    recipients: string[];
-    /** Subject line of the email. */
-    subject: string;
-    /** HTML body content of the email. */
-    html: string;
-}
-declare class Emails extends APIResource {
-    /**
-     * Dispatch a bulk email campaign to a list of recipients.
-     *
-     * @param params - The campaign details (recipients, subject, html).
-     * @returns The dispatch result.
-     * @example
-     * ```typescript
-     * await erixClient.marketing.emails.sendCampaign({
-     *   recipients: ["user@example.com"],
-     *   subject: "Special Offer",
-     *   html: "<p>Check out our deal!</p>"
-     * });
-     * ```
-     */
-    sendCampaign<T = any>(params: SendCampaignParams): Promise<T>;
-    /**
-     * Send a test verification email (used to verify SMTP functionality).
-     *
-     * @param to - The recipient email address for the test email.
-     * @returns A promise resolving to the result of the test email dispatch.
-     * @example
-     * ```typescript
-     * await erixClient.marketing.emails.sendTest("admin@mycompany.com");
-     * ```
-     */
-    sendTest<T = any>(to: string): Promise<T>;
-}
-declare class Campaigns extends APIResource {
-    /**
-     * List all email marketing campaigns with optional status filtering.
-     *
-     * @param params - Optional filters (status, limit, startDate, endDate, page).
-     * @returns Paginated list of campaign objects.
-     * @example
-     * ```typescript
-     * const campaigns = await erixClient.marketing.campaigns.list({ status: "sent" });
-     * ```
-     */
-    list<T = any>(params?: {
-        status?: string;
-        limit?: number;
-        page?: number;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<T>;
-    /**
-     * Get detailed delivery and engagement statistics for a campaign.
-     * Includes opens, clicks, bounces, and delivery failures.
-     *
-     * @param campaignId - The ID of the campaign.
-     * @returns Stats summary object.
-     * @example
-     * ```typescript
-     * const report = await erixClient.marketing.campaigns.stats("camp_123");
-     * console.log(`Open Rate: ${report.data.openRate}%`);
-     * ```
-     */
-    stats<T = any>(campaignId: string): Promise<T>;
-}
-declare class WhatsAppMarketing extends APIResource {
-    /**
-     * Dispatch a template-based WhatsApp message with CRM-integrated variable resolution.
-     *
-     * Unlike direct WhatsApp sending, this endpoint automatically pulls data from the CRM
-     * based on the provided variables mapping.
-     *
-     * @param params - Template details and recipient phone.
-     * @example
-     * ```typescript
-     * await erixClient.marketing.whatsapp.sendTemplate({
-     *   phone: "+919876543210",
-     *   templateName: "order_update",
-     *   variables: { "1": "Order #123" }
-     * });
-     * ```
-     */
-    sendTemplate<T = any>(params: {
-        /** Recipient's phone number. */
-        phone: string;
-        /** The WhatsApp template name approved in Meta. */
-        templateName: string;
-        /** Language code for the template (e.g. en_US). */
-        languageCode?: string;
-        /** CRM mapped variables. */
-        variables?: Record<string, string>;
-        /** Directly resolved variables to inject into the template. */
-        resolvedVariables?: Record<string, string>;
-    }): Promise<T>;
-}
-/**
- * Global Marketing resource namespace.
- *
- * Access via `ecod.marketing`.
- */
-declare class Marketing extends APIResource {
-    /** Email marketing resources */
-    emails: Emails;
-    /** Campaign analytics and lists */
-    campaigns: Campaigns;
-    /** WhatsApp marketing resources */
-    whatsapp: WhatsAppMarketing;
-    constructor(client: any);
-}
-
-/**
- * Options for the `upload()` elite helper.
- */
-interface UploadOptions {
-    /**
-     * The destination folder key in R2.
-     * @example "customer_documents" | "avatars" | "invoices"
-     */
-    folder: string;
-    /**
-     * The desired filename, including extension.
-     * @example "contract.pdf" | "profile.jpg"
-     */
-    filename: string;
-    /**
-     * The MIME type of the file.
-     * @example "application/pdf" | "image/jpeg" | "video/mp4"
-     */
-    contentType: string;
-}
-/**
- * Cloudflare R2-backed media resource.
- *
- * Access via `ecod.media`.
- *
- * The `upload()` method is the recommended approach. It acts as a client-side
- * orchestrator: it fetches a presigned URL from the backend, uploads directly
- * to R2 (bypassing the API server), then confirms the upload — all in one call.
- *
- * @example
- * ```typescript
- * const { data } = await ecod.media.upload(fileBuffer, {
- *   folder: "invoices",
- *   filename: "invoice-001.pdf",
- *   contentType: "application/pdf",
- * });
- * console.log(data.url); // → https://cdn.ecodrix.com/invoices/invoice-001.pdf
- * ```
- */
-declare class Media extends APIResource {
-    /**
-     * Get current storage usage metrics for the tenant.
-     *
-     * @returns `{ usedMB, limitMB, fileCount }`
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.media.getUsage();
-     * console.log(`${data.usedMB} / ${data.limitMB} MB used`);
-     * ```
-     */
-    getUsage(): Promise<unknown>;
-    /**
-     * Create a new top-level folder in the tenant's R2 bucket.
-     *
-     * @param name - Folder name (alphanumeric, hyphens, underscores).
-     *
-     * @example
-     * ```typescript
-     * await ecod.media.createFolder("patient_records");
-     * ```
-     */
-    createFolder(name: string): Promise<unknown>;
-    /**
-     * List files within a folder, with optional date / search filtering.
-     *
-     * @param folder - The folder name to list, **or `"*"` to fetch all folders**
-     *   for the tenant in a single call (returns a merged flat list with a
-     *   `folder` field on each file so callers can group/filter client-side).
-     * @param params - Optional `year`, `month`, and keyword search `q` filters.
-     * @returns `{ data: { files, count, totalSizeBytes } }`.
-     *
-     * @example Single folder
-     * ```typescript
-     * const { data } = await ecod.media.list("invoices", { q: "contract" });
-     * // data.files → files only from the "invoices" folder
-     * ```
-     *
-     * @example All folders
-     * ```typescript
-     * const { data } = await ecod.media.list("*");
-     * // data.files → merged files from every folder the tenant has
-     * // Each file has a `folder` field indicating its source folder
-     * ```
-     */
-    list(folder: string, params?: {
-        year?: string;
-        month?: string;
-        q?: string;
-    }): Promise<unknown>;
-    /**
-     * Delete a file from R2 by its storage key.
-     *
-     * @param key - The full storage key of the file (e.g. `"invoices/contract.pdf"`).
-     *
-     * @example
-     * ```typescript
-     * await ecod.media.delete("invoices/old-contract.pdf");
-     * ```
-     */
-    delete(key: string): Promise<unknown>;
-    /**
-     * Request a temporary presigned download URL for a private file.
-     *
-     * @param key - The full storage key of the file.
-     * @returns `{ url }` — a time-limited download URL.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.media.getDownloadUrl("invoices/contract.pdf");
-     * // → { url: "https://cdn.ecodrix.com/...?token=..." }
-     * ```
-     */
-    getDownloadUrl(key: string): Promise<unknown>;
-    /**
-     * **Elite Upload Helper** — uploads a file to Cloudflare R2 in a single call.
-     *
-     * This orchestrates 3 steps transparently:
-     * 1. Fetch a presigned `PUT` URL from the ECODrIx backend.
-     * 2. Upload the file _directly_ to R2 (no API proxy, maximum throughput).
-     * 3. Confirm the upload with the backend so it is indexed and tracked.
-     *
-     * Works with Node.js `Buffer`, browser `File`/`Blob`, or any stream-like
-     * object that Axios can PUT.
-     *
-     * @param file - The file data to upload.
-     * @param options - Folder, filename, and content type.
-     * @returns Confirmed file metadata including `key` and `url`.
-     *
-     * @example Node.js
-     * ```typescript
-     * import { readFileSync } from "fs";
-     * const buf = readFileSync("./invoice.pdf");
-     * const { data } = await ecod.media.upload(buf, {
-     *   folder: "invoices",
-     *   filename: "invoice-001.pdf",
-     *   contentType: "application/pdf",
-     * });
-     * ```
-     *
-     * @example Browser
-     * ```typescript
-     * const file = inputElement.files[0];
-     * const { data } = await ecod.media.upload(file, {
-     *   folder: "avatars",
-     *   filename: file.name,
-     *   contentType: file.type,
-     * });
-     * ```
-     */
-    upload(file: any, options: UploadOptions): Promise<any>;
-}
-
-/**
- * Parameters for scheduling a new Google Meet appointment.
- */
-interface CreateMeetingParams {
-    /** The CRM Lead ID this meeting belongs to. */
-    leadId: string;
-    /** Full name of the external participant. */
-    participantName: string;
-    /** Phone number of the participant in E.164 format. */
-    participantPhone: string;
-    /** Email addresses of the participants. */
-    participantEmails?: string[];
-    /**
-     * Meeting start time.
-     * @example new Date("2026-04-10T10:00:00.000Z")
-     */
-    startTime: Date | string;
-    /**
-     * Meeting end time.
-     * @example new Date("2026-04-10T10:30:00.000Z")
-     */
-    endTime: Date | string;
-    /** Duration in minutes. */
-    duration?: number;
-    /** Whether the meeting is online (Google Meet) or offline (In-person). */
-    meetingMode?: "online" | "offline";
-    /** Whether this is a free or paid consultation. */
-    type?: "free" | "paid";
-    /** Amount charged for paid consultations. */
-    amount?: number;
-    /** Arbitrary metadata to attach to the meeting record. */
-    metadata?: {
-        refs?: Record<string, string | undefined>;
-        extra?: Record<string, any>;
-    };
-}
-/**
- * Parameters for updating an existing meeting.
- */
-interface UpdateMeetingParams {
-    /**
-     * Update the meeting status.
-     * @example "scheduled" | "completed" | "cancelled"
-     */
-    status?: "scheduled" | "completed" | "cancelled" | string;
-    /** Update the payment status for paid consultations. */
-    paymentStatus?: "pending" | "paid" | "na" | string;
-    /** New start time for rescheduling. */
-    startTime?: Date | string;
-    /** New end time for rescheduling. */
-    endTime?: Date | string;
-    /** Duration in minutes. */
-    duration?: number;
-    /** Update metadata. */
-    metadata?: any;
-}
-/**
- * Google Meet appointment scheduling resource.
- *
- * Access via `ecod.meet`.
- *
- * @example
- * ```typescript
- * const { data } = await ecod.meet.create({
- *   leadId: "64abc...",
- *   participantName: "Alice",
- *   participantPhone: "+919876543210",
- *   startTime: "2026-04-10T10:00:00Z",
- *   endTime: "2026-04-10T10:30:00Z",
- * });
- * console.log(data.meetLink); // → https://meet.google.com/abc-defg-hij
- * ```
- */
-declare class Meetings extends APIResource {
-    /**
-     * Schedule a new Google Meet with a lead.
-     *
-     * The backend automatically creates a Google Calendar event and generates
-     * a Meet link, then sends confirmation notifications via WhatsApp.
-     *
-     * @param data - Meeting details.
-     * @returns The created Meeting document including `meetLink`.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.meet.create({
-     *   leadId: "64abc...",
-     *   participantName: "Alice",
-     *   participantPhone: "+91...",
-     *   startTime: "2026-04-10T10:00:00Z",
-     *   endTime: "2026-04-10T10:30:00Z",
-     * });
-     * ```
-     */
-    create(data: CreateMeetingParams): Promise<any>;
-    /**
-     * List all meetings for the tenant, with optional filters.
-     *
-     * @param params - `leadId` to filter by lead; `status` to filter by state.
-     * @returns Array of Meeting documents.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.meet.list({ status: "scheduled" });
-     * ```
-     */
-    list(params?: {
-        leadId?: string;
-        status?: string;
-    }): Promise<any>;
-    /**
-     * Retrieve the full details for a specific meeting.
-     *
-     * @param meetingId - The unique meeting ID.
-     * @returns The Meeting document.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.meet.retrieve("meeting_id");
-     * ```
-     */
-    retrieve(meetingId: string): Promise<any>;
-    /**
-     * Update or reschedule an existing meeting.
-     *
-     * Partial updates are supported — only supply the fields you wish to change.
-     *
-     * @param meetingId - The meeting to update.
-     * @param data - Fields to update.
-     * @returns The updated Meeting document.
-     *
-     * @example
-     * ```typescript
-     * // Reschedule
-     * await ecod.meet.update("meeting_id", {
-     *   startTime: "2026-04-11T11:00:00Z",
-     *   endTime: "2026-04-11T11:30:00Z",
-     * });
-     * ```
-     */
-    update<T = any>(meetingId: string, data: UpdateMeetingParams): Promise<T>;
-    /**
-     * Reschedule an existing meeting. Provides explicit method for time modifications.
-     */
-    reschedule<T = any>(meetingId: string, params: {
-        startTime: Date | string;
-        endTime: Date | string;
-        duration?: number;
-    }): Promise<T>;
-    /**
-     * Cancel a meeting. This sets the meeting status to `"cancelled"`.
-     *
-     * @param meetingId - The meeting to cancel.
-     *
-     * @example
-     * ```typescript
-     * await ecod.meet.delete("meeting_id");
-     * ```
-     */
-    delete(meetingId: string): Promise<any>;
-}
-
-/**
- * Filters for querying event and automation execution logs.
- */
-interface LogFilter {
-    /** Page number for pagination (1-indexed). */
-    page?: number;
-    /** Maximum number of records to return per page. */
-    limit?: number;
-    /**
-     * Filter by automation trigger name.
-     * @example "lead_created" | "appointment_booked"
-     */
-    trigger?: string;
-    /**
-     * Filter by execution status.
-     * @example "success" | "failed" | "pending"
-     */
-    status?: string;
-    /** Filter logs associated with a specific phone number. */
-    phone?: string;
-    /** Start of the date range (inclusive). ISO 8601 or Date object. */
-    startDate?: string | Date;
-    /** End of the date range (inclusive). ISO 8601 or Date object. */
-    endDate?: string | Date;
-}
-/**
- * Automation event log and provider callback resource.
- *
- * Access via `ecod.notifications`.
- *
- * This resource is **read-only**. It exposes platform audit trails — useful
- * for debugging automation failures, monitoring webhook callbacks, and
- * building internal ops dashboards.
- *
- * @example
- * ```typescript
- * // Find failed automations in April
- * const { data } = await ecod.notifications.listLogs({
- *   status: "failed",
- *   startDate: "2026-04-01",
- *   endDate: "2026-04-30",
- * });
- * ```
- */
-declare class Notifications extends APIResource {
-    /**
-     * List automation execution logs with optional filtering.
-     *
-     * Each log entry represents one automation run triggered by a platform event.
-     * Filter by `status: "failed"` to build a failure alerting pipeline.
-     *
-     * @param params - Optional filter criteria.
-     * @returns Paginated list of event log objects.
-     *
-     * @example
-     * ```typescript
-     * const { data: failed } = await ecod.notifications.listLogs({
-     *   status: "failed",
-     *   trigger: "lead_created",
-     *   limit: 50,
-     * });
-     * ```
-     */
-    listLogs(params?: LogFilter): Promise<unknown>;
-    /**
-     * Retrieve the full details for a single automation event log entry.
-     *
-     * @param logId - The unique log ID.
-     * @returns A single event log document including the payload and error trace.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.notifications.retrieveLog("log_64abc...");
-     * console.log(data.error);  // → "Provider timeout after 30s"
-     * ```
-     */
-    retrieveLog(logId: string): Promise<unknown>;
-    /**
-     * Get a summary statistics object for automation event execution.
-     *
-     * @param params - Optional date range for the summary window.
-     * @returns `{ total, success, failed, pending }` counts.
-     *
-     * @example
-     * ```typescript
-     * const { data: stats } = await ecod.notifications.getStats({
-     *   startDate: "2026-04-01",
-     *   endDate: "2026-04-30",
-     * });
-     * console.log(`Failed: ${stats.failed} / ${stats.total}`);
-     * ```
-     */
-    getStats(params?: {
-        startDate?: string;
-        endDate?: string;
-    }): Promise<unknown>;
-    /**
-     * List external provider webhook callback logs.
-     *
-     * These are inbound HTTP callbacks from third-party providers
-     * (payment gateways, email services, etc.) stored for audit purposes.
-     *
-     * @param params - Pagination and date filter options.
-     * @returns Paginated list of callback log records.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.notifications.listCallbacks({ limit: 20 });
-     * ```
-     */
-    listCallbacks(params?: Omit<LogFilter, "trigger" | "phone">): Promise<unknown>;
-    /**
-     * List unread CRM notifications and alerts (e.g., lead assignments, system alerts).
-     *
-     * @param params - Optional filters (limit, unreadOnly).
-     * @returns Paginated list of notification objects.
-     * @example
-     * ```typescript
-     * const alerts = await erixClient.notifications.listAlerts({ unreadOnly: true });
-     * ```
-     */
-    listAlerts<T = any>(params?: {
-        limit?: number;
-        unreadOnly?: boolean;
-    }): Promise<T>;
-    /**
-     * Dismiss/mark a specific notification alert as read.
-     *
-     * @param notificationId - The unique ID of the notification.
-     * @example
-     * ```typescript
-     * await erixClient.notifications.dismissAlert("alert_123");
-     * ```
-     */
-    dismissAlert<T = any>(notificationId: string): Promise<T>;
-    /**
-     * Clear all notifications for the current tenant immediately.
-     *
-     * @example
-     * ```typescript
-     * await erixClient.notifications.clearAllAlerts();
-     * ```
-     */
-    clearAllAlerts<T = any>(): Promise<T>;
-    /**
-     * Retry an action from a notification (e.g. failed automation send).
-     *
-     * @param notificationId - The unique ID of the notification.
-     * @example
-     * ```typescript
-     * await erixClient.notifications.retryAction("alert_123");
-     * ```
-     */
-    retryAction<T = any>(notificationId: string): Promise<T>;
-}
-
-interface JobStats {
-    waiting: number;
-    active: number;
-    completed: number;
-    failed: number;
-    delayed: number;
-}
-declare class Queue extends APIResource {
-    /**
-     * List all background jobs that have failed execution.
-     *
-     * @returns Array of failed job objects.
-     * @example
-     * ```typescript
-     * const failed = await erixClient.queue.listFailed();
-     * ```
-     */
-    listFailed<T = any>(): Promise<T>;
-    /**
-     * Get real-time health statistics for the background job queue (waiting, active, failed).
-     *
-     * @returns Queue statistics summary.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.queue.getStats();
-     * console.log(`Active Jobs: ${stats.active}`);
-     * ```
-     */
-    getStats<T = JobStats>(): Promise<T>;
-    /**
-     * Manually retry a failed background job.
-     *
-     * @param jobId - The unique ID of the failed job.
-     * @example
-     * ```typescript
-     * await erixClient.queue.retryJob("job_123");
-     * ```
-     */
-    retryJob<T = any>(jobId: string): Promise<T>;
-    /**
-     * Remove a job from the queue.
-     *
-     * @param jobId - The unique ID of the job to delete.
-     * @example
-     * ```typescript
-     * await erixClient.queue.deleteJob("job_123");
-     * ```
-     */
-    deleteJob<T = any>(jobId: string): Promise<T>;
-}
-
-declare class Clients extends APIResource {
-    /**
-     * List all clients in the ecosystem.
-     */
-    list<T = any>(): Promise<T>;
-    /**
-     * Get client count and auto-generate a unique code.
-     */
-    getCountAndGenerateCode<T = any>(): Promise<T>;
-    /**
-     * Retrieve a single client by client code.
-     */
-    retrieve<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Get API Key for a specific client (Admin Only).
-     */
-    getApiKey<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Generate or rotate API Key for a specific client (Admin Only).
-     */
-    rotateApiKey<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Create a new client identity and provision initial resources.
-     */
-    create<T = any>(payload: {
-        name: string;
-        clientCode: string;
-        business?: any;
-        plan?: any;
-    }): Promise<T>;
-    /**
-     * Get active service configuration for a specific client.
-     */
-    getConfig<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Update active service configuration for a specific client.
-     */
-    updateConfig<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Get decrypted secrets for a specific client.
-     */
-    getSecrets<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Set secrets for a specific client.
-     */
-    updateSecrets<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Completely replace secrets for a specific client.
-     */
-    replaceSecrets<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Partially update secrets for a specific client.
-     */
-    patchSecrets<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Retrieve Data Source connection metadata.
-     */
-    getDataSource<T = any>(clientCode: string): Promise<T>;
-    /**
-     * Configure Data Source metadata.
-     */
-    manageDataSource<T = any>(clientCode: string, payload: any): Promise<T>;
-    /**
-     * Update Client Identity and perform cascading updates if required.
-     */
-    updateIdentity<T = any>(id: string, payload: any): Promise<T>;
-    /**
-     * Initiate Google Re-authentication for OAuth tokens.
-     */
-    googleReauth<T = any>(clientCode: string, payload?: {
-        authCode?: string;
-    }): Promise<T>;
-    /**
-     * Delete a client and perform cascading cleanup.
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-declare class Blogs extends APIResource {
-    /**
-     * Retrieve public corporate blogs/news.
-     */
-    list<T = any>(): Promise<T>;
-}
-declare class GlobalLeads extends APIResource {
-    /**
-     * Add a corporate lead capture entry.
-     */
-    add<T = any>(payload: any): Promise<T>;
-}
-declare class Services extends APIResource {
-    clients: Clients;
-    blogs: Blogs;
-    globalLeads: GlobalLeads;
-    constructor(client: any);
-}
-
-declare class EmailConfig extends APIResource {
-    /**
-     * Retrieve current email provider configuration and domain verification statuses.
-     */
-    getConfig<T = any>(): Promise<T>;
-    /**
-     * Switch the active email provider.
-     */
-    switchProvider<T = any>(provider: string): Promise<T>;
-    /**
-     * Provide explicit SMTP credentials and connection preferences.
-     */
-    saveSmtp<T = any>(payload: any): Promise<T>;
-    /**
-     * Initialize a new domain for SES identity verification.
-     */
-    initDomainVerification<T = any>(domain: string): Promise<T>;
-    /**
-     * Confirm "From" details and finalize configuration payload.
-     */
-    saveEmailConfig<T = any>(payload: {
-        fromName: string;
-        fromEmail: string;
-        replyTo?: string;
-    }): Promise<T>;
-    /**
-     * Check status of AWS SES domain validation DNS records.
-     */
-    checkSesVerification<T = any>(): Promise<T>;
-    /**
-     * Remove a verified SES domain identity and clean up local secrets.
-     */
-    removeSesIdentity<T = any>(): Promise<T>;
-    /**
-     * Send a test email to verify infrastructure is correctly bound.
-     */
-    sendTest<T = any>(toEmail: string): Promise<T>;
-    /**
-     * Define customized global email footers, limits, and specific campaign policies.
-     */
-    saveAdvancedConfig<T = any>(payload: any): Promise<T>;
-    /**
-     * Retrieve email configuration health properties including bounce limits metrics.
-     */
-    getHealth<T = any>(): Promise<T>;
-    /**
-     * Upgrade configurations dynamically to add DMARC enforcement records.
-     */
-    fixDmarc<T = any>(): Promise<T>;
-    /**
-     * Discover internally available providers constants metadata.
-     */
-    listProviders<T = any>(): Promise<T>;
-}
-declare class Settings extends APIResource {
-    email: EmailConfig;
-    constructor(client: any);
-}
-
-declare class Folders extends APIResource {
-    /**
-     * Create a new folder in the tenant's cloud storage.
-     *
-     * @param name - The name of the folder to create.
-     * @example
-     * ```typescript
-     * await erixClient.storage.folders.create("Invoices");
-     * ```
-     */
-    create<T = any>(name: string): Promise<T>;
-    /**
-     * Delete a folder and its contents.
-     */
-    delete<T = any>(folderPath: string): Promise<T>;
-}
-declare class Files extends APIResource {
-    /**
-     * List files within a specific folder.
-     *
-     * @param folder - The folder name or path.
-     * @param params - Optional year/month filters for organized storage.
-     * @example
-     * ```typescript
-     * const files = await erixClient.storage.files.list("Invoices", { year: "2026" });
-     * ```
-     */
-    list<T = any>(folder: string, params?: {
-        year?: string;
-        month?: string;
-    }): Promise<T>;
-    /**
-     * Get a presigned upload URL for direct-to-cloud browser uploads.
-     * This allows the client to upload files directly to R2/S3 without hitting the backend.
-     *
-     * @param params - Upload parameters (folder, filename, contentType).
-     * @example
-     * ```typescript
-     * const { data } = await erixClient.storage.files.getUploadUrl({
-     *   folder: "Invoices",
-     *   filename: "inv_1.pdf",
-     *   contentType: "application/pdf"
-     * });
-     * // Now use data.url with a PUT request
-     * ```
-     */
-    getUploadUrl<T = any>(params: {
-        folder: string;
-        filename: string;
-        contentType: string;
-    }): Promise<T>;
-    /**
-     * Notify backend after a successful direct browser upload.
-     */
-    confirmUpload<T = any>(params: {
-        key: string;
-        sizeBytes: number;
-    }): Promise<T>;
-    /**
-     * Get a presigned download URL for an R2 key.
-     */
-    getDownloadUrl<T = any>(key: string): Promise<T>;
-    /**
-     * Delete a file by key.
-     */
-    delete(key: string): Promise<unknown>;
-}
-declare class Storage extends APIResource {
-    folders: Folders;
-    files: Files;
-    constructor(client: any);
-    /**
-     * Get tenant storage usage and quota limitations.
-     */
-    usage<T = any>(): Promise<T>;
-}
-
-/**
- * Typed error hierarchy for the @ecodrix/erix-api SDK.
- *
- * All errors thrown by the SDK extend `EcodrixError`, so a single
- * `catch` block can handle them all, while still allowing granular
- * differentiation between auth failures, rate limits, and generic API errors.
- *
- * @example
- * ```typescript
- * import { APIError, AuthenticationError, RateLimitError } from "@ecodrix/erix-api";
- *
- * try {
- *   await ecod.crm.leads.retrieve("invalid_id");
- * } catch (err) {
- *   if (err instanceof AuthenticationError) {
- *     console.error("Invalid API key or client code.");
- *   } else if (err instanceof RateLimitError) {
- *     console.warn("Slow down — rate limit hit.");
- *   } else if (err instanceof APIError) {
- *     console.error(`API error ${err.status}: ${err.message}`);
- *   }
- * }
- * ```
- */
-/** Base class for all ECODrIx SDK errors. */
-declare class EcodrixError extends Error {
-    constructor(message: string);
-}
-/**
- * Represents an error returned by the ECODrIx API.
- * Carries the HTTP `status` code and an optional `code` string.
- */
-declare class APIError extends EcodrixError {
-    /** HTTP status code returned by the API (e.g. 400, 404, 500). */
-    status?: number;
-    /** Machine-readable error code (e.g. `"NOT_FOUND"`, `"VALIDATION_ERROR"`). */
-    code?: string;
-    constructor(message: string, status?: number, code?: string);
-}
-/**
- * Thrown when the API key or client code is missing, invalid, or expired.
- * HTTP 401.
- */
-declare class AuthenticationError extends APIError {
-    constructor(message?: string);
-}
-/**
- * Thrown when the rate limit for the API key has been exceeded.
- * HTTP 429. Implement exponential backoff before retrying.
- */
-declare class RateLimitError extends APIError {
-    constructor(message?: string);
-}
-
-/**
- * Validates and constructs webhook events sent by the ECODrIx platform.
- * Ensures the payload has not been tampered with.
- *
- * @example
- * ```typescript
- * import { ecod } from "./services/ecodrix";
- *
- * app.post("/api/webhooks", async (req, res) => {
- *   try {
- *     const event = await ecod.webhooks.constructEvent(
- *       req.rawBody,
- *       req.headers["x-ecodrix-signature"],
- *       process.env.ECOD_WEBHOOK_SECRET
- *     );
- *     console.log("Verified event:", event.type);
- *     res.send({ received: true });
- *   } catch (err) {
- *     res.status(400).send(`Webhook Error: ${err.message}`);
- *   }
- * });
- * ```
- */
-declare class Webhooks {
-    /**
-     * Cryptographically validates a webhook payload.
-     * Note: This method dynamically imports Node's `crypto` module, meaning it will only execute gracefully in a Server environment.
-     *
-     * @param payload - The raw request body as a string or Buffer.
-     * @param signature - The `x-ecodrix-signature` header value.
-     * @param secret - The webhook signing secret for your tenant.
-     * @returns The parsed JSON object of the event if the signature is valid.
-     * @throws WebhookSignatureError if the validation fails.
-     */
-    constructEvent(payload: string | Buffer, signature: string | string[] | undefined, secret: string): Promise<any>;
-}
-
-interface CreateBroadcastParams {
-    /** Optional name for the broadcast campaign */
-    name?: string;
-    /** Name of the Meta template to send */
-    templateName: string;
-    /** Language code (defaults to en_US) */
-    templateLanguage?: string;
-    /** List of recipients with their phone numbers and variable overrides */
-    recipients: {
-        phone: string;
-        variables?: string[];
-    }[];
-}
-declare class Broadcasts extends APIResource {
-    /**
-     * List past and active WhatsApp broadcast campaigns.
-     *
-     * @param params - Optional filter parameters (page, limit, status).
-     * @returns Paginated list of broadcast records.
-     * @example
-     * ```typescript
-     * const broadcasts = await erixClient.whatsapp.broadcasts.list({ limit: 10 });
-     * ```
-     */
-    list<T = any>(params?: Record<string, any>): Promise<T>;
-    /**
-     * Retrieve full details and real-time stats for a specific broadcast campaign.
-     *
-     * @param id - The unique identifier of the broadcast.
-     * @returns The broadcast record including sent/failed counts.
-     * @example
-     * ```typescript
-     * const stats = await erixClient.whatsapp.broadcasts.retrieve("bc_123");
-     * console.log(`Success Rate: ${(stats.sentCount / stats.totalRecipients) * 100}%`);
-     * ```
-     */
-    retrieve<T = any>(id: string): Promise<T>;
-    /**
-     * Create a new broadcast campaign to send template messages to multiple recipients.
-     *
-     * @param params - Broadcast configuration (name, templateName, recipients).
-     * @returns The newly created broadcast record.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.create({
-     *   name: "Spring Sale",
-     *   templateName: "promo_code",
-     *   recipients: [
-     *     { phone: "+919876543210", variables: ["SAVE10"] }
-     *   ]
-     * });
-     * ```
-     */
-    create<T = any>(params: CreateBroadcastParams): Promise<T>;
-    /**
-     * Update broadcast metadata, such as its name or administrative status.
-     *
-     * @param id - The unique ID of the broadcast.
-     * @param data - The fields to update (name, status).
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.update("bc_123", { name: "Revised Spring Sale" });
-     * ```
-     */
-    update<T = any>(id: string, data: {
-        name?: string;
-        status?: string;
-    }): Promise<T>;
-    /**
-     * Delete a broadcast campaign record.
-     * Note: This does not cancel messages already in flight but removes the record from the dashboard.
-     *
-     * @param id - The unique ID of the broadcast.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.broadcasts.delete("bc_123");
-     * ```
-     */
-    delete<T = any>(id: string): Promise<T>;
-}
-
-interface ListParams {
-    limit?: number;
-    before?: string;
-    after?: string;
-    status?: string;
-}
-declare class Conversations extends APIResource {
-    /**
-     * List conversations for the tenant.
-     * @deprecated Use `list` method from `ErixClient` instead.
-     * @param params - List parameters.
-     * @returns List of conversations.
-     * @example
-     * ```typescript
-     * import { ErixClient } from "erix-react";
-     * const erixClient = new ErixClient({ apiKey: "YOUR_API_KEY" });
-     * const conversations = await erixClient.whatsapp.conversations.list();
-     * ```
-     */
-    list<T = any>(params?: ListParams): Promise<T>;
-    /**
-     * Create a new conversation explicitly.
-     *
-     * @param params - Conversation details.
-     * @example
-     * ```typescript
-     * const conversation = await erixClient.whatsapp.conversations.create({
-     *   phone: "+919876543210",
-     *   name: "John Doe"
-     * });
-     * ```
-     */
-    create<T = any>(params: {
-        phone: string;
-        name?: string;
-    }): Promise<T>;
-    /**
-     * Retrieve details of a specific conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * const conversation = await erixClient.whatsapp.conversations.retrieve("conv_123");
-     * ```
-     */
-    retrieve<T = any>(conversationId: string): Promise<T>;
-    /**
-     * Get messages for a specific conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @param params - Pagination and filter parameters.
-     * @example
-     * ```typescript
-     * const messages = await erixClient.whatsapp.conversations.messages("conv_123", { limit: 50 });
-     * ```
-     */
-    messages<T = any>(conversationId: string, params?: ListParams): Promise<T>;
-    /**
-     * Link a conversation to a lead in the CRM.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @param leadId - The unique ID of the lead to link.
-     * @param leadData - Optional additional lead metadata.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.linkLead("conv_123", "lead_456");
-     * ```
-     */
-    linkLead<T = any>(conversationId: string, leadId: string, leadData?: any): Promise<T>;
-    /**
-     * Mark a conversation as read (clear unread count).
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.markRead("conv_123");
-     * ```
-     */
-    markRead<T = any>(conversationId: string): Promise<T>;
-    /**
-     * Delete a conversation.
-     *
-     * @param conversationId - The unique ID of the conversation.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.delete("conv_123");
-     * ```
-     */
-    delete(conversationId: string): Promise<unknown>;
-    /**
-     * Bulk delete conversations.
-     *
-     * @param ids - Array of conversation IDs to delete.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.conversations.bulkDelete(["conv_1", "conv_2"]);
-     * ```
-     */
-    bulkDelete<T = any>(ids: string[]): Promise<T>;
-}
-
-/**
- * Parameters for sending a free-form WhatsApp message.
- */
-interface SendMessageParams {
-    /**
-     * Recipient's phone number in E.164 format.
-     * @example "+919876543210"
-     */
-    to?: string;
-    /**
-     * The unique ID of the conversation. If supplied, `to` is resolved automatically.
-     */
-    conversationId?: string;
-    /** Plain text body of the message. */
-    text?: string;
-    /** Public URL of the media asset to send. */
-    mediaUrl?: string;
-    /** MIME category of the media. */
-    mediaType?: "image" | "video" | "audio" | "document";
-    /** The `messageId` of the message to reply to (quoted replies). */
-    replyToId?: string;
-    /** Filename shown to the recipient (required for `document` type). */
-    filename?: string;
-    /** Arbitrary metadata stored with the message record. */
-    metadata?: Record<string, any>;
-    /** Template name for template messages. */
-    templateName?: string;
-    /** Template language for template messages. */
-    templateLanguage?: string;
-    /** Alternative language parameter. */
-    language?: string;
-    /** Template variables. */
-    variables?: string[];
-}
-/**
- * Parameters for sending a pre-approved WhatsApp Business template.
- */
-interface SendTemplateParams {
-    /**
-     * Recipient's phone number in E.164 format.
-     * @example "+919876543210"
-     */
-    to?: string;
-    /**
-     * The unique ID of the conversation.
-     */
-    conversationId?: string;
-    /** The exact template name as approved in Meta Business Manager. */
-    templateName: string;
-    /**
-     * BCP-47 language code for the template.
-     * @default "en_US"
-     */
-    language?: string;
-    /**
-     * Ordered array of variable substitutions for template placeholders.
-     * @example ["Alice", "10 April 2026", "10:00 AM"]
-     */
-    variables?: string[];
-    /** Optional header media URL (for templates with media headers). */
-    mediaUrl?: string;
-    /** Media type for the header (e.g. "image", "document"). */
-    mediaType?: string;
-    /** User ID of the agent sending the message. */
-    userId?: string;
-    /** Optional filename for media headers. */
-    filename?: string;
-    /** Template language for template messages. */
-    templateLanguage?: string;
-}
-/**
- * WhatsApp outbound messaging resource.
- *
- * Access via `ecod.whatsapp.messages`.
- *
- * @example
- * ```typescript
- * await ecod.whatsapp.messages.send({
- *   to: "+919876543210",
- *   text: "Your appointment is confirmed!",
- * });
- * ```
- */
-/**
- * Resolved media metadata returned by any upload endpoint.
- * `variants` is only present for raster images (JPEG, PNG, WebP, AVIF, GIF).
- */
-interface ChatMediaMeta {
-    /** Raw CDN URL — always present, all media types */
-    url: string;
-    /** Categorical type — "image" | "video" | "audio" | "document" */
-    type: "image" | "video" | "audio" | "document";
-    /** Cloudflare-optimised variant URLs. Only present for raster images. */
-    variants?: {
-        /** 150px WebP — use for list thumbnails and chat bubbles */
-        thumb: string;
-        /** 600px WebP — use for modal previews */
-        medium: string;
-        /** 1200px WebP — use for hero or full-screen views */
-        full: string;
-        /** Original CDN URL, no transformation */
-        raw: string;
-    };
-    /** Storage key within the tenant bucket */
-    key?: string;
-    /** Original filename */
-    fileName?: string;
-}
-declare class Messages extends APIResource {
-    /**
-     * Send a free-text or media message to a WhatsApp number.
-     *
-     * For text-only messages, supply `text`. For media, supply `mediaUrl`
-     * and `mediaType`. Both can be combined in a single message.
-     *
-     * @param params - Message parameters including recipient, text, and media.
-     * @returns The created message record from the database.
-     *
-     * @example Send a simple text message
-     * ```typescript
-     * await erixClient.whatsapp.messages.send({
-     *   to: "+919876543210",
-     *   text: "Hello from Ecodrix!",
-     * });
-     * ```
-     *
-     * @example Send an image with a caption
-     * ```typescript
-     * await erixClient.whatsapp.messages.send({
-     *   to: "+919876543210",
-     *   text: "Check out this flyer",
-     *   mediaUrl: "https://example.com/flyer.jpg",
-     *   mediaType: "image",
-     * });
-     * ```
-     */
-    send<T = any>(params: SendMessageParams): Promise<T>;
-    /**
-     * Send a pre-approved WhatsApp Business template message.
-     *
-     * Templates must be approved in Meta Business Manager before they can be sent.
-     * Variable placeholders (e.g., {{1}}, {{2}}) are replaced with values from the
-     * `variables` array in order.
-     *
-     * @param params - Template message configuration (name, language, variables).
-     * @returns The created message record.
-     *
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.messages.sendTemplate({
-     *   to: "+919876543210",
-     *   templateName: "welcome_user",
-     *   language: "en_US",
-     *   variables: ["Alice"], // Replaces {{1}} in template
-     * });
-     * ```
-     */
-    sendTemplate<T = any>(params: SendTemplateParams): Promise<T>;
-    /**
-     * Star or unstar a message.
-     *
-     * @param messageId - The ID of the message.
-     * @param isStarred - Boolean indicating whether to star or unstar.
-     */
-    star<T = any>(messageId: string, isStarred: boolean): Promise<T>;
-    /**
-     * React to a message with an emoji.
-     *
-     * @param messageId - The ID of the message.
-     * @param reaction - The emoji (e.g. "👍") to react with, or empty string to remove.
-     */
-    react<T = any>(messageId: string, reaction: string): Promise<T>;
-    /**
-     * Mark all messages in a conversation as read (double-tick).
-     *
-     * @param conversationId - The conversation to mark as read.
-     *
-     * @example
-     * ```typescript
-     * await ecod.whatsapp.messages.markRead("conv_64abc...");
-     * ```
-     */
-    markRead(conversationId: string): Promise<unknown>;
-    /**
-     * Upload a media file for WhatsApp chat.
-     *
-     * Works with any file type — image, video, audio, or document.
-     * For raster images the response includes Cloudflare-optimised `variants`
-     * (thumb 150px, medium 600px, full 1200px). Non-image types return only `url`.
-     *
-     * @param file - The file to upload (File, Blob, or Buffer).
-     * @returns Full media metadata `{ url, type, variants?, key, fileName }`.
-     *
-     * @example
-     * ```typescript
-     * const file = input.files[0];
-     * const { data } = await ecod.whatsapp.messages.upload(file);
-     * // For images: data.variants.thumb → 150px WebP from Cloudflare
-     * // For video/audio: use data.url directly in <video> or <audio>
-     * ```
-     */
-    upload(file: any): Promise<{
-        success: boolean;
-        data: ChatMediaMeta;
-    }>;
-}
-
-interface TemplateMapping {
-    mappings: any[];
-    onEmptyVariable: string;
-}
-declare class Templates extends APIResource {
-    /**
-     * List all WhatsApp message templates in the tenant database.
-     *
-     * @param params - Optional filter parameters (status, mappingStatus, channel).
-     * @returns List of message templates.
-     * @example
-     * ```typescript
-     * const templates = await erixClient.whatsapp.templates.list({ status: "APPROVED" });
-     * ```
-     */
-    list<T = any>(params?: {
-        status?: string;
-        mappingStatus?: string;
-        channel?: string;
-    }): Promise<T>;
-    /**
-     * Synchronize templates from the Meta WhatsApp Business API.
-     * This updates the local database with the latest template status and content from Meta.
-     *
-     * @returns Success status of the sync operation.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.templates.sync();
-     * ```
-     */
-    sync<T = any>(): Promise<T>;
-    /**
-     * Retrieve details of a specific WhatsApp template.
-     *
-     * @param templateIdentifier - The name or ID of the template.
-     * @returns Detailed template object including components and status.
-     * @example
-     * ```typescript
-     * const template = await erixClient.whatsapp.templates.retrieve("welcome_message");
-     * ```
-     */
-    retrieve<T = any>(templateIdentifier: string): Promise<T>;
-    /**
-     * Create a new WhatsApp template manually (Draft).
-     *
-     * @param payload - Template configuration (name, category, language, components).
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.templates.create({
-     *   name: "new_promotion",
-     *   category: "MARKETING",
-     *   language: "en_US",
-     *   components: [...]
-     * });
-     * ```
-     */
-    create<T = any>(payload: any): Promise<T>;
-    /**
-     * Update an existing WhatsApp template.
-     *
-     * @param templateId - The unique ID of the template.
-     * @param payload - Updated template configuration.
-     */
-    update<T = any>(templateId: string, payload: any): Promise<T>;
-    /**
-     * Delete a WhatsApp template from both the local database and Meta (if specified).
-     *
-     * @param templateName - The name of the template to delete.
-     * @param force - If true, attempts to delete from Meta API as well.
-     * @example
-     * ```typescript
-     * await erixClient.whatsapp.templates.deleteTemplate("old_template", true);
-     * ```
-     */
-    deleteTemplate<T = any>(templateName: string, force?: boolean): Promise<T>;
-    /**
-     * List available configuration options for variable mapping.
-     *
-     * @example
-     * ```typescript
-     * const config = await erixClient.whatsapp.templates.mappingConfig();
-     * ```
-     */
-    mappingConfig<T = any>(): Promise<T>;
-    /**
-     * List CRM collections available for variable mapping (Leads, Deals, etc.).
-     */
-    collections<T = any>(): Promise<T>;
-    /**
-     * List fields for a specific CRM collection to be used in mapping.
-     *
-     * @param collectionName - The name of the CRM collection.
-     */
-    collectionFields<T = any>(collectionName: string): Promise<T>;
-    /**
-     * Update variable mappings for a template to automate personalization.
-     *
-     * @param templateName - Name of the template.
-     * @param payload - Mapping definitions.
-     */
-    updateMapping<T = any>(templateName: string, payload: TemplateMapping): Promise<T>;
-    /**
-     * Validate if a template is ready for automated sending based on its mappings.
-     */
-    validate<T = any>(templateName: string): Promise<T>;
-    /**
-     * Preview a template resolution with sample data.
-     *
-     * @param templateName - Name of the template.
-     * @param context - Lead data or variable overrides for preview.
-     * @example
-     * ```typescript
-     * const preview = await erixClient.whatsapp.templates.preview("welcome", {
-     *   lead: { firstName: "Alice" }
-     * });
-     * ```
-     */
-    preview<T = any>(templateName: string, context: {
-        lead?: any;
-        vars?: any;
-    }): Promise<T>;
-    /**
-     * Introspect a template and provide a manifest of its required variables.
-     *
-     * This is used by Erix React to build dynamic "Mapping Forms" where users
-     * can connect CRM fields to WhatsApp variables.
-     *
-     * @param templateIdentifier - The name or ID of the template.
-     */
-    getVariableManifest(templateIdentifier: string): Promise<ResourceManifest>;
-    /**
-     * Check which automations or sequences are currently using this template.
-     */
-    checkUsage<T = any>(templateName: string): Promise<T>;
-}
-
-interface SendTemplatePayload {
-    /** Phone number in E.164 format. */
-    phone: string;
-    /** Name of the pre-approved WhatsApp template. */
-    templateName: string;
-    /** Language code (defaults to "en"). */
-    languageCode?: string;
-    /** Key-value pairs matching variables in your template (e.g., {{1}}, {{2}}). */
-    variables?: Record<string, string>;
-    /** Explicitly resolved variables if bypassing the internal resolution engine. */
-    resolvedVariables?: any[];
-}
-declare class WhatsApp extends APIResource {
-    messages: Messages;
-    conversations: Conversations;
-    broadcasts: Broadcasts;
-    templates: Templates;
-    constructor(client: AxiosInstance);
-    /**
-     * Upload an asset directly to chat storage.
-     */
-    upload<T = any>(file: Blob | Buffer | File | any, filename: string): Promise<T>;
-    /**
-     * Dispatch a WhatsApp template message directly to a specific phone number.
-     * Bypasses the automation queue for immediate high-priority delivery.
-     *
-     * @param payload - The template dispatch payload.
-     * @returns Information about the dispatched message.
-     */
-    sendTemplate(payload: SendTemplatePayload): Promise<{
-        success: boolean;
-        messageId?: string;
-        templateName?: string;
-        resolvedVariables?: any[];
-    }>;
-}
-
-/**
- * Configuration options for the ECODrIxAPI client.
- *
- * Minimum required: `apiKey` and `clientCode`.
- * The backend URL is managed internally and should not need to be changed.
- */
-interface ECODrIxAPIOptions {
-    /**
-     * Your ECODrIx Platform API key.
-     * Obtain this from the ECODrIx dashboard under Settings → API Keys.
-     * @example "ecod_live_sk_..."
-     */
-    apiKey: string;
-    /**
-     * Your tenant ID (Client Code).
-     * This scopes all API requests to your specific organisation.
-     * @example "ERIX_CLNT_JHBJHF"
-     */
-    clientCode?: string;
-    /**
-     * Optional Core API Key for deep system-level bypasses.
-     * Only used by elevated internal SaaS modules like Nirvisham.
-     */
-    coreApiKey?: string;
-    /**
-     * @internal Override Socket.io URL for testing/staging.
-     * Not documented — internal use only.
-     */
-    socketUrl?: string;
-    /**
-     * @internal Override the backend API URL. Used by the CLI and internal tests only.
-     * Host projects must never set this — the production URL is hardcoded internally.
-     */
-    baseUrl?: string;
-}
-/**
- * The primary entry point for the ECODrIx SDK.
- *
- * Initialise once with your credentials and use the namespaced resources
- * to interact with every part of the platform.
- *
- * @example
- * ```typescript
- * import { ECODrIxAPI } from "@ecodrix/erix-api";
- *
- * const ecod = new ECODrIxAPI({
- *   apiKey: process.env.ECOD_API_KEY!,
- *   clientCode: "ERIX_CLNT_JHBJHF",
- * });
- *
- * await ecod.whatsapp.messages.send({ to: "+91...", text: "Hello!" });
- * const lead = await ecod.crm.leads.create({ firstName: "Alice", phone: "+91..." });
- * ```
- */
-declare class ECODrIxAPI {
-    /**
-     * @internal Axios HTTP client for making API requests.
-     */
-    private readonly client;
-    /**
-     * @internal Socket.io client for real-time events.
-     */
-    private readonly socket;
-    /**
-     * The tenant client code this SDK instance is scoped to.
-     * Useful for components that need to read the clientCode back
-     * from a context-provided SDK instance.
-     */
-    readonly clientCode: string | undefined;
-    /** WhatsApp messaging and conversation management. */
-    readonly whatsapp: WhatsApp;
-    /** CRM resources — Leads and related sub-resources. */
-    readonly crm: CRM;
-    /** Cloudflare R2-backed media storage. */
-    readonly media: Media;
-    /** Google Meet appointment scheduling. */
-    readonly meet: Meetings;
-    /** Automation execution logs and provider webhook callbacks. */
-    readonly notifications: Notifications;
-    /** Outbound email marketing engine and template management. */
-    readonly email: Email;
-    /** Platform-wide execution logs and audit trails. */
-    readonly logs: Logs;
-    /** Lead events and workflow automation triggers. */
-    readonly events: EventsResource;
-    /** Cryptographic webhook signature verification. */
-    readonly webhooks: Webhooks;
-    /** Tenant Cloud Storage mapping. */
-    readonly storage: Storage;
-    /** Email and SMS Marketing Campaigns. */
-    readonly marketing: Marketing;
-    /** Platform and tenant health diagnostics. */
-    readonly health: Health;
-    /** Background job queue management. */
-    readonly queue: Queue;
-    /** White-Label Agency administration. */
-    readonly agency: Agency;
-    /** Multi-tenant Identity & Lifecycle services. */
-    readonly services: Services;
-    /** Tenant environment and provider settings. */
-    readonly settings: Settings;
-    /** Dynamic Cross-Origin Resource Sharing network policies. */
-    readonly cors: Cors;
-    /** ErixCheckout one-click checkout flow management. */
-    readonly checkout: Checkout;
-    constructor(options: ECODrIxAPIOptions);
-    /**
-     * Join a specific real-time room (e.g., a conversation or a lead).
-     *
-     * @param roomId - The unique identifier for the room.
-     */
-    joinRoom(roomId: string): void;
-    /**
-     * Leave a previously joined real-time room.
-     *
-     * @param roomId - The unique identifier for the room.
-     */
-    leaveRoom(roomId: string): void;
-    private setupSocket;
-    /**
-     * Subscribe to a real-time event emitted by the ECODrIx platform.
-     *
-     * The SDK maintains a persistent Socket.io connection. Events are
-     * scoped to your `clientCode` — you will only receive events for
-     * your own tenant.
-     *
-     * **Standard events:**
-     * - `new_message` — inbound WhatsApp message (includes conversation and message payload)
-     * - `message_sent` — outbound message successfully sent
-     * - `message_status_update` — WhatsApp message status change (delivered, read, failed)
-     * - `conversation_updated` — metadata change (unread count, last message, status)
-     * - `message_updated` — real-time updates for reactions or media processing
-     * - `notification:new` — new system or CRM notification
-     * - `workflow-run-update` — automation execution progress
-     * - `meet.scheduled` — Google Meet appointment booked
-     *
-     * @param event - The event name to subscribe to.
-     * @param callback - The handler function invoked when the event fires.
-     * @returns `this` for method chaining.
-     *
-     * @example
-     * ```typescript
-     * ecod
-     *   .on("whatsapp.message_received", (msg) => console.log(msg.body))
-     *   .on("automation.failed", (err) => alertTeam(err));
-     * ```
-     */
-    on(event: string, callback: (...args: any[]) => void): this;
-    /**
-     * Gracefully disconnect the real-time Socket.io connection.
-     * Call this when shutting down your server or when the client is
-     * no longer needed to free up resources.
-     *
-     * @example
-     * ```typescript
-     * process.on("SIGTERM", () => ecod.disconnect());
-     * ```
-     */
-    disconnect(): void;
-    /**
-     * Remove a previously registered event listener.
-     * Always call this in cleanup (e.g. React `useEffect` return) to prevent
-     * memory leaks and duplicate handlers after reconnections.
-     *
-     * @param event - The event name to unsubscribe from.
-     * @param callback - The exact handler reference passed to `.on()`.
-     * @returns `this` for method chaining.
-     */
-    off(event: string, callback: (...args: any[]) => void): this;
-    /**
-     * Raw Execution Escape-Hatch.
-     * Send an authenticated HTTP request directly to the ECODrIx backend from ANY external project.
-     *
-     * This is extremely powerful giving you full unrestricted access to make calls
-     * against new, experimental, or completely custom backend APIs while still benefitting
-     * from the SDK's built-in authentication and automatic `axios-retry` logic.
-     *
-     * @example
-     * ```typescript
-     * const { data } = await ecod.request("POST", "/api/saas/experimental-feature", { flag: true });
-     * console.log(data);
-     * ```
-     */
-    request<T = any>(method: Method, path: string, data?: any, params?: any): Promise<T>;
-}
-
-export { APIError, type ApplyCouponPayload, AuthenticationError, type CheckoutAmountBreakdown, type CheckoutOrderResponse, type CheckoutProduct, type CheckoutSession, type CreateOrderPayload, type CreateSessionPayload, ECODrIxAPI as ECODrIx, ECODrIxAPI, type ECODrIxAPIOptions, EcodrixError, type FieldManifest, type FieldType, RateLimitError, type ResourceManifest, type VerifyPayload, ECODrIxAPI as default };