@startsimpli/api 0.2.3 → 0.2.5

package/dist/index.d.ts

@@ -1,2235 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Common API types for Django REST Framework
- */
-interface PaginatedResponse<T> {
-    count: number;
-    next: string | null;
-    previous: string | null;
-    results: T[];
-}
-interface ApiError$1 {
-    detail?: string;
-    message?: string;
-    errors?: Record<string, string[]>;
-    status?: number;
-    statusText?: string;
-}
-interface PaginationParams {
-    page?: number;
-    pageSize?: number;
-}
-interface SortParams {
-    ordering?: string;
-}
-interface ApiRequestConfig {
-    headers?: HeadersInit;
-    signal?: AbortSignal;
-}
-type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-interface FetchOptions extends RequestInit {
-    params?: Record<string, unknown>;
-}
-
-interface ApiError {
-    code: string;
-    message: string;
-    details?: unknown;
-}
-interface ApiResponse<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: ApiError;
-}
-declare enum ErrorCodes {
-    UNAUTHORIZED = "UNAUTHORIZED",
-    FORBIDDEN = "FORBIDDEN",
-    NOT_FOUND = "NOT_FOUND",
-    VALIDATION_ERROR = "VALIDATION_ERROR",
-    CONFLICT = "CONFLICT",
-    INTERNAL_ERROR = "INTERNAL_ERROR",
-    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
-    RATE_LIMITED = "RATE_LIMITED"
-}
-type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
-interface AsyncState<T> {
-    status: AsyncStatus;
-    data: T | null;
-    error: string | null;
-}
-
-/**
- * Entity system types matching Django core models
- */
-type EntityType$1 = 'contact' | 'organization';
-interface Entity {
-    id: string;
-    entityType: EntityType$1;
-    createdAt: string;
-    updatedAt: string;
-    tags?: EntityTag[];
-    metrics?: Metric[];
-    profiles?: Profile[];
-    attributes?: Attribute[];
-    relationshipsFrom?: Relationship[];
-    relationshipsTo?: Relationship[];
-    roleAssignments?: RoleAssignment[];
-    events?: Event[];
-}
-interface Tag {
-    id: number;
-    category: string;
-    name: string;
-    description?: string;
-    fullPath: string;
-}
-interface EntityTag {
-    id: number;
-    category: string;
-    name: string;
-    tagDescription?: string;
-    confidence: number;
-    appliedAt: string;
-    appliedBy?: string;
-    metadata?: Record<string, unknown>;
-}
-interface Metric {
-    id: number;
-    type: string;
-    subtype: string;
-    value: number | string | null;
-    valueNumeric?: number | null;
-    valueText?: string | null;
-    unit?: string;
-    asOfDate?: string;
-    periodStart?: string;
-    confidence: number;
-    metadata?: Record<string, unknown>;
-}
-interface Profile {
-    id: number;
-    type: string;
-    subtype: string;
-    identifier: string;
-    identifierType: string;
-    displayName: string;
-    verified: boolean;
-    verifiedAt?: string;
-    metadata?: Record<string, unknown>;
-}
-interface Attribute {
-    id: number;
-    type: string;
-    subtype: string;
-    value: string | Record<string, unknown> | null;
-    valueText?: string | null;
-    valueJson?: Record<string, unknown> | null;
-    valueType: 'text' | 'json';
-    validFrom?: string;
-    validTo?: string;
-    isCurrent: boolean;
-    confidence: number;
-    metadata?: Record<string, unknown>;
-}
-interface Relationship {
-    id: number;
-    fromEntityId: string;
-    toEntityId: string;
-    type: string;
-    subtype?: string;
-    validFrom?: string;
-    validTo?: string;
-    isCurrent: boolean;
-    durationDays?: number;
-    strength?: number;
-    confidence: number;
-    metadata?: Record<string, unknown>;
-}
-interface RoleAssignment {
-    id: number;
-    contactId: string;
-    orgId: string;
-    type: string;
-    subtype?: string;
-    title?: string;
-    seniority?: string;
-    validFrom?: string;
-    validTo?: string;
-    isCurrent: boolean;
-    durationDays?: number;
-    confidence: number;
-    metadata?: Record<string, unknown>;
-}
-interface Event {
-    id: number;
-    type: string;
-    subtype?: string;
-    occurredAt?: string;
-    announcedAt?: string;
-    magnitude?: number;
-    confidence: number;
-    metadata?: Record<string, unknown>;
-    participants?: EventParticipant[];
-}
-interface EventParticipant {
-    id: number;
-    entityId: string;
-    roleType: string;
-    roleSubtype?: string;
-    metadata?: Record<string, unknown>;
-}
-interface Source {
-    id: number;
-    type: string;
-    subtype?: string;
-    identifier: string;
-    retrievedAt: string;
-    format: string;
-    confidence: number;
-    cost?: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Writable assertion formats for POST/PATCH
- */
-interface WritableAssertions {
-    writeTags?: Array<string | {
-        category: string;
-        name: string;
-        confidence?: number;
-    }>;
-    writeMetrics?: Record<string, number | string>;
-    writeProfiles?: Record<string, string>;
-    writeAttributes?: Record<string, string | Record<string, unknown>>;
-}
-
-/**
- * Contact types matching Django Contact model
- */
-
-interface Contact extends Entity {
-    name: string;
-    email?: string | null;
-    phone?: string | null;
-    title?: string | null;
-    companyName?: string | null;
-    location?: string | null;
-    notes?: string | null;
-    tier?: number | null;
-    status?: string | null;
-    linkedin?: string | null;
-    twitter?: string | null;
-    website?: string | null;
-    firmId?: string | null;
-    firmName?: string | null;
-    enrichmentScore?: number | null;
-}
-interface CreateContactRequest extends WritableAssertions {
-    name: string;
-    email?: string;
-    phone?: string;
-    title?: string;
-    companyName?: string;
-    location?: string;
-    notes?: string;
-}
-interface UpdateContactRequest extends Partial<CreateContactRequest> {
-}
-interface ContactFilters {
-    [key: string]: unknown;
-    search?: string;
-    tier?: number;
-    status?: string;
-    firmId?: string;
-    tagCategory?: string;
-    tagName?: string;
-    hasEmail?: boolean;
-    hasLinkedin?: boolean;
-}
-
-/**
- * Organization types matching Django Organization model
- */
-
-interface Organization extends Entity {
-    name: string;
-    domain?: string | null;
-    description?: string | null;
-    location?: string | null;
-    tier?: number | null;
-    stage?: string | null;
-    focusAreas?: string[];
-    checkSizeMin?: number | null;
-    checkSizeMax?: number | null;
-    aum?: number | string | null;
-    portfolioCount?: number | null;
-    linkedin?: string | null;
-    twitter?: string | null;
-    crunchbase?: string | null;
-    website?: string | null;
-    foundedYear?: number | null;
-}
-interface CreateOrganizationRequest extends WritableAssertions {
-    name: string;
-    domain?: string;
-    description?: string;
-    location?: string;
-}
-interface UpdateOrganizationRequest extends Partial<CreateOrganizationRequest> {
-}
-interface OrganizationFilters {
-    [key: string]: unknown;
-    search?: string;
-    tier?: number;
-    stage?: string;
-    focusArea?: string;
-    checkSizeMinGte?: number;
-    checkSizeMaxLte?: number;
-    aumGte?: number;
-    location?: string;
-    tagCategory?: string;
-    tagName?: string;
-}
-
-/**
- * Funnel types matching Django Funnel models
- *
- * Funnels are brutally generic - they can represent:
- * - Lead scoring funnels
- * - Investor qualification stages
- * - Customer segmentation
- * - Any multi-stage entity classification
- */
-type FunnelStatus = 'draft' | 'active' | 'archived';
-type EntityType = 'contact' | 'organization';
-/**
- * Filter rule for funnel stage
- */
-interface FunnelStageRule {
-    id: number;
-    fieldPath: string;
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'contains' | 'notContains' | 'startswith' | 'endswith' | 'in' | 'notIn' | 'isnull' | 'isnotnull' | 'arrayContains' | 'arrayOverlaps';
-    value: string | number | boolean | null;
-    logic?: 'AND' | 'OR';
-}
-/**
- * Funnel stage with rules
- */
-interface FunnelStage {
-    id: number;
-    name: string;
-    description?: string;
-    order: number;
-    rules: FunnelStageRule[];
-    entityCount?: number;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Funnel - brutally generic entity classification system
- */
-interface Funnel {
-    id: string;
-    name: string;
-    description: string;
-    status: FunnelStatus;
-    tags?: string[];
-    entityType: EntityType;
-    /**
-     * @deprecated Legacy field for backward compatibility
-     */
-    inputType?: 'contacts' | 'organizations' | 'both' | 'any';
-    stages: FunnelStage[];
-    stageCount: number;
-    totalRuns: number;
-    lastRunAt: string | null;
-    createdBy: string;
-    createdByName: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Funnel result for a specific entity
- */
-interface FunnelResult {
-    id: number;
-    funnel: string;
-    entity: string;
-    entityType: EntityType;
-    stage: number | null;
-    stageName: string | null;
-    score: number | null;
-    metadata: Record<string, any>;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Funnel execution run
- */
-interface FunnelRun {
-    id: string;
-    funnel: string;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    totalEntities: number;
-    processedEntities: number;
-    resultsByStage: Record<string, number>;
-    startedAt: string | null;
-    completedAt: string | null;
-    errorMessage: string | null;
-    createdBy: string;
-    createdAt: string;
-}
-/**
- * Filters for listing funnels
- */
-interface FunnelFilters {
-    status?: FunnelStatus;
-    entityType?: EntityType;
-    search?: string;
-    tags?: string[];
-    createdBy?: string;
-    page?: number;
-    pageSize?: number;
-    ordering?: string;
-}
-/**
- * Input for creating a funnel
- */
-interface CreateFunnelInput {
-    name: string;
-    description?: string;
-    status?: FunnelStatus;
-    tags?: string[];
-    entityType: EntityType;
-    stages?: Omit<FunnelStage, 'id' | 'createdAt' | 'updatedAt' | 'entityCount'>[];
-}
-/**
- * Input for updating a funnel
- */
-interface UpdateFunnelInput extends Partial<CreateFunnelInput> {
-}
-/**
- * Input for executing a funnel
- */
-interface ExecuteFunnelInput {
-    entityIds?: string[];
-    filters?: Record<string, any>;
-}
-
-/**
- * Workflow types matching Django Workflow models
- *
- * Workflows are n8n-style node-based automation flows
- */
-type WorkflowStatus = 'draft' | 'active' | 'paused';
-interface Workflow$1 {
-    id: string;
-    name: string;
-    description: string;
-    team: string;
-    createdBy: string | null;
-    nodes: any[];
-    connections: Record<string, any>;
-    settings: Record<string, any>;
-    staticData: Record<string, any>;
-    isActive: boolean;
-    version: number;
-    isTemplate: boolean;
-    templateSource: string | null;
-    executionsCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface WorkflowExecution$1 {
-    id: string;
-    workflow: string;
-    workflowVersion: number;
-    triggeredBy: string;
-    status: 'pending' | 'running' | 'completed' | 'failed' | 'paused';
-    mode: 'manual' | 'trigger' | 'webhook';
-    contextData: Record<string, any>;
-    state: Record<string, any>;
-    startedAt: string | null;
-    completedAt: string | null;
-    waitUntil: string | null;
-    errorMessage: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface WorkflowFilters$1 {
-    team?: string;
-    isActive?: boolean;
-    isTemplate?: boolean;
-    page?: number;
-    pageSize?: number;
-    ordering?: string;
-}
-interface ExecuteWorkflowInput$1 {
-    contextData?: Record<string, any>;
-    mode?: 'manual' | 'trigger' | 'webhook';
-}
-interface CreateWorkflowInput$1 {
-    name: string;
-    description?: string;
-    team: string;
-    nodes?: any[];
-    connections?: Record<string, any>;
-    settings?: Record<string, any>;
-    isActive?: boolean;
-}
-interface UpdateWorkflowInput extends Partial<CreateWorkflowInput$1> {
-}
-
-/**
- * Standardized API error response types
- *
- * Provides consistent error handling across frontend and backend
- */
-
-/**
- * Field-level validation error
- */
-interface FieldError {
-    field: string;
-    messages: string[];
-    code?: string;
-}
-/**
- * Standardized API error response
- */
-interface StandardErrorResponse {
-    /** Main error message (user-friendly) */
-    error: string;
-    /** Error type/code for programmatic handling */
-    code: string;
-    /** HTTP status code */
-    statusCode: number;
-    /** Field-level validation errors */
-    fieldErrors?: FieldError[];
-    /** Additional error details */
-    details?: Record<string, unknown>;
-    /** Request ID for debugging */
-    requestId?: string;
-    /** Timestamp of error */
-    timestamp?: string;
-}
-/**
- * Zod schema for runtime validation
- */
-declare const FieldErrorSchema: z.ZodObject<{
-    field: z.ZodString;
-    messages: z.ZodArray<z.ZodString, "many">;
-    code: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    field: string;
-    messages: string[];
-    code?: string | undefined;
-}, {
-    field: string;
-    messages: string[];
-    code?: string | undefined;
-}>;
-declare const StandardErrorResponseSchema: z.ZodObject<{
-    error: z.ZodString;
-    code: z.ZodString;
-    statusCode: z.ZodNumber;
-    fieldErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        field: z.ZodString;
-        messages: z.ZodArray<z.ZodString, "many">;
-        code: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        field: string;
-        messages: string[];
-        code?: string | undefined;
-    }, {
-        field: string;
-        messages: string[];
-        code?: string | undefined;
-    }>, "many">>;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    requestId: z.ZodOptional<z.ZodString>;
-    timestamp: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    error: string;
-    code: string;
-    statusCode: number;
-    fieldErrors?: {
-        field: string;
-        messages: string[];
-        code?: string | undefined;
-    }[] | undefined;
-    details?: Record<string, unknown> | undefined;
-    requestId?: string | undefined;
-    timestamp?: string | undefined;
-}, {
-    error: string;
-    code: string;
-    statusCode: number;
-    fieldErrors?: {
-        field: string;
-        messages: string[];
-        code?: string | undefined;
-    }[] | undefined;
-    details?: Record<string, unknown> | undefined;
-    requestId?: string | undefined;
-    timestamp?: string | undefined;
-}>;
-/**
- * Common error codes
- */
-declare enum ErrorCode {
-    BAD_REQUEST = "bad_request",
-    UNAUTHORIZED = "unauthorized",
-    FORBIDDEN = "forbidden",
-    NOT_FOUND = "not_found",
-    METHOD_NOT_ALLOWED = "method_not_allowed",
-    VALIDATION_ERROR = "validation_error",
-    CONFLICT = "conflict",
-    RATE_LIMITED = "rate_limited",
-    INTERNAL_ERROR = "internal_error",
-    SERVICE_UNAVAILABLE = "service_unavailable",
-    GATEWAY_TIMEOUT = "gateway_timeout",
-    NETWORK_ERROR = "network_error",
-    TIMEOUT = "timeout",
-    UNKNOWN = "unknown"
-}
-/**
- * Map HTTP status codes to error codes
- */
-declare function getErrorCodeFromStatus(status: number): ErrorCode;
-/**
- * User-friendly error messages
- */
-declare const ErrorMessages: Record<ErrorCode, string>;
-
-/**
- * Type-safe fetch wrapper for Django REST API
- */
-
-interface FetchWrapperConfig {
-    baseUrl?: string;
-    getToken?: () => Promise<string | null> | string | null;
-    onUnauthorized?: () => void;
-    onTokenRefresh?: () => Promise<string | null>;
-    defaultHeaders?: HeadersInit;
-}
-declare class FetchWrapper {
-    private config;
-    private isRefreshing;
-    private refreshPromise;
-    constructor(config: FetchWrapperConfig);
-    /**
-     * Build headers with auth token
-     */
-    private buildHeaders;
-    /**
-     * Execute fetch request
-     */
-    private execute;
-    /**
-     * Return a new FetchWrapper with selected config fields overridden.
-     */
-    reconfigure(partial: Partial<FetchWrapperConfig>): FetchWrapper;
-    /**
-     * GET request
-     */
-    get<T>(endpoint: string, options?: FetchOptions): Promise<T>;
-    /**
-     * POST request
-     */
-    post<T, D = unknown>(endpoint: string, data?: D, options?: FetchOptions): Promise<T>;
-    /**
-     * PUT request
-     */
-    put<T, D = unknown>(endpoint: string, data?: D, options?: FetchOptions): Promise<T>;
-    /**
-     * PATCH request
-     */
-    patch<T, D = unknown>(endpoint: string, data?: D, options?: FetchOptions): Promise<T>;
-    /**
-     * DELETE request
-     */
-    delete<T>(endpoint: string, options?: FetchOptions): Promise<T>;
-}
-
-/**
- * Main API client for Django REST API
- */
-
-interface ApiClientConfig {
-    baseUrl?: string;
-    getToken?: () => Promise<string | null> | string | null;
-    onUnauthorized?: () => void;
-    onTokenRefresh?: () => Promise<string | null>;
-}
-declare class ApiClient {
-    private fetcher;
-    readonly baseUrl: string;
-    constructor(config: ApiClientConfig);
-    /**
-     * Get the fetch wrapper instance for direct access
-     */
-    get fetch(): FetchWrapper;
-    /**
-     * Update auth token getter
-     */
-    setTokenGetter(getToken: () => Promise<string | null> | string | null): void;
-    /**
-     * Update unauthorized handler
-     */
-    setUnauthorizedHandler(onUnauthorized: () => void): void;
-    /**
-     * Convenience HTTP methods that delegate to FetchWrapper
-     */
-    get<T>(endpoint: string, options?: FetchOptions): Promise<T>;
-    post<T, D = unknown>(endpoint: string, data?: D, options?: FetchOptions): Promise<T>;
-    patch<T, D = unknown>(endpoint: string, data?: D, options?: FetchOptions): Promise<T>;
-    delete<T>(endpoint: string, options?: FetchOptions): Promise<T>;
-}
-/**
- * Create API client instance
- */
-declare function createApiClient(config: ApiClientConfig): ApiClient;
-
-/**
- * Contacts API wrapper for /api/v1/contacts/
- */
-
-declare class ContactsApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * List contacts with pagination and filters
-     */
-    list(filters?: ContactFilters, pagination?: PaginationParams, sorting?: SortParams): Promise<PaginatedResponse<Contact>>;
-    /**
-     * Get contact by ID
-     */
-    get(id: string): Promise<Contact>;
-    /**
-     * Create new contact
-     */
-    create(data: CreateContactRequest): Promise<Contact>;
-    /**
-     * Update contact
-     */
-    update(id: string, data: UpdateContactRequest): Promise<Contact>;
-    /**
-     * Delete contact
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Bulk create contacts
-     */
-    bulkCreate(data: CreateContactRequest[]): Promise<Contact[]>;
-    /**
-     * Search contacts by name, email, or company
-     */
-    search(query: string, pagination?: PaginationParams): Promise<PaginatedResponse<Contact>>;
-    /**
-     * Get contacts by tier
-     */
-    getByTier(tier: number, pagination?: PaginationParams): Promise<PaginatedResponse<Contact>>;
-    /**
-     * Get contacts by firm
-     */
-    getByFirm(firmId: string, pagination?: PaginationParams): Promise<PaginatedResponse<Contact>>;
-    /**
-     * Get contacts with LinkedIn profiles
-     */
-    getWithLinkedIn(pagination?: PaginationParams): Promise<PaginatedResponse<Contact>>;
-}
-
-/**
- * Organizations API wrapper for /api/v1/organizations/
- */
-
-declare class OrganizationsApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * List organizations with pagination and filters
-     */
-    list(filters?: OrganizationFilters, pagination?: PaginationParams, sorting?: SortParams): Promise<PaginatedResponse<Organization>>;
-    /**
-     * Get organization by ID
-     */
-    get(id: string): Promise<Organization>;
-    /**
-     * Create new organization
-     */
-    create(data: CreateOrganizationRequest): Promise<Organization>;
-    /**
-     * Update organization
-     */
-    update(id: string, data: UpdateOrganizationRequest): Promise<Organization>;
-    /**
-     * Delete organization
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Bulk create organizations
-     */
-    bulkCreate(data: CreateOrganizationRequest[]): Promise<Organization[]>;
-    /**
-     * Search organizations by name, domain, or location
-     */
-    search(query: string, pagination?: PaginationParams): Promise<PaginatedResponse<Organization>>;
-    /**
-     * Get organizations by tier
-     */
-    getByTier(tier: number, pagination?: PaginationParams): Promise<PaginatedResponse<Organization>>;
-    /**
-     * Get organizations by stage
-     */
-    getByStage(stage: string, pagination?: PaginationParams): Promise<PaginatedResponse<Organization>>;
-    /**
-     * Get organizations by focus area
-     */
-    getByFocusArea(focusArea: string, pagination?: PaginationParams): Promise<PaginatedResponse<Organization>>;
-    /**
-     * Get organizations by check size range
-     */
-    getByCheckSizeRange(min?: number, max?: number, pagination?: PaginationParams): Promise<PaginatedResponse<Organization>>;
-}
-
-/**
- * Core entities API wrapper for /api/v1/core/
- */
-
-declare class EntitiesApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * Tags
-     */
-    listTags(pagination?: PaginationParams): Promise<PaginatedResponse<Tag>>;
-    getTag(id: number): Promise<Tag>;
-    createTag(data: Partial<Tag>): Promise<Tag>;
-    /**
-     * Entity Tags
-     */
-    listEntityTags(pagination?: PaginationParams, filters?: {
-        entityId?: string;
-        tagId?: number;
-        category?: string;
-    }): Promise<PaginatedResponse<EntityTag>>;
-    getEntityTag(id: number): Promise<EntityTag>;
-    /**
-     * Metrics
-     */
-    listMetrics(pagination?: PaginationParams, filters?: {
-        entityId?: string;
-        type?: string;
-        subtype?: string;
-    }): Promise<PaginatedResponse<Metric>>;
-    getMetric(id: number): Promise<Metric>;
-    /**
-     * Profiles
-     */
-    listProfiles(pagination?: PaginationParams, filters?: {
-        entityId?: string;
-        type?: string;
-        subtype?: string;
-    }): Promise<PaginatedResponse<Profile>>;
-    getProfile(id: number): Promise<Profile>;
-    /**
-     * Attributes
-     */
-    listAttributes(pagination?: PaginationParams, filters?: {
-        entityId?: string;
-        type?: string;
-        subtype?: string;
-        isCurrent?: boolean;
-    }): Promise<PaginatedResponse<Attribute>>;
-    getAttribute(id: number): Promise<Attribute>;
-    /**
-     * Relationships
-     */
-    listRelationships(pagination?: PaginationParams, filters?: {
-        fromEntityId?: string;
-        toEntityId?: string;
-        type?: string;
-        isCurrent?: boolean;
-    }): Promise<PaginatedResponse<Relationship>>;
-    getRelationship(id: number): Promise<Relationship>;
-}
-
-/**
- * Workflows API wrapper
- *
- * Provides type-safe access to Django Workflows API
- */
-
-interface Workflow {
-    id: string;
-    name: string;
-    description: string;
-    team: string;
-    createdBy: string | null;
-    nodes: any[];
-    connections: Record<string, any>;
-    settings: Record<string, any>;
-    staticData: Record<string, any>;
-    isActive: boolean;
-    version: number;
-    isTemplate: boolean;
-    templateSource: string | null;
-    executionsCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface WorkflowExecution {
-    id: string;
-    workflow: string;
-    workflowVersion: number;
-    triggeredBy: string;
-    status: 'pending' | 'running' | 'completed' | 'failed' | 'paused';
-    mode: 'manual' | 'trigger' | 'webhook';
-    contextData: Record<string, any>;
-    state: Record<string, any>;
-    startedAt: string | null;
-    completedAt: string | null;
-    waitUntil: string | null;
-    errorMessage: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface WorkflowFilters {
-    team?: string;
-    isActive?: boolean;
-    isTemplate?: boolean;
-    page?: number;
-    pageSize?: number;
-    ordering?: string;
-}
-interface ExecuteWorkflowInput {
-    contextData?: Record<string, any>;
-    mode?: 'manual' | 'trigger' | 'webhook';
-}
-interface CreateWorkflowInput {
-    name: string;
-    description?: string;
-    team: string;
-    nodes?: any[];
-    connections?: Record<string, any>;
-    settings?: Record<string, any>;
-    isActive?: boolean;
-}
-declare class WorkflowsApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * List workflows with optional filters
-     */
-    list(filters?: WorkflowFilters): Promise<{
-        results: Workflow[];
-        count: number;
-        next: string | null;
-        previous: string | null;
-    }>;
-    /**
-     * Get workflow by ID
-     */
-    get(id: string): Promise<Workflow>;
-    /**
-     * Create a new workflow
-     */
-    create(data: CreateWorkflowInput): Promise<Workflow>;
-    /**
-     * Update workflow
-     */
-    update(id: string, data: Partial<CreateWorkflowInput>): Promise<Workflow>;
-    /**
-     * Delete workflow
-     */
-    delete(id: string): Promise<unknown>;
-    /**
-     * Execute workflow
-     */
-    execute(id: string, input?: ExecuteWorkflowInput): Promise<WorkflowExecution>;
-    /**
-     * Get workflow templates
-     */
-    templates(): Promise<Workflow[]>;
-    /**
-     * List workflow executions
-     */
-    listExecutions(filters?: {
-        workflow?: string;
-        status?: string;
-        page?: number;
-        pageSize?: number;
-    }): Promise<{
-        results: WorkflowExecution[];
-        count: number;
-    }>;
-    /**
-     * Get workflow execution details
-     */
-    getExecution(id: string): Promise<WorkflowExecution>;
-}
-
-/**
- * Messages API wrapper
- *
- * Provides type-safe access to Django Messages API
- */
-
-type MessageStatus = 'draft' | 'scheduled' | 'sending' | 'sent' | 'failed';
-type MessageContentType = 'text/plain' | 'text/markdown' | 'text/html';
-type RecipientStatus = 'pending' | 'sent' | 'delivered' | 'bounced' | 'opened' | 'clicked';
-interface Message {
-    id: string;
-    team: string;
-    channel: string;
-    channelDetails?: {
-        key: string;
-        name: string;
-        description: string;
-        icon: string;
-    };
-    subject: string;
-    body: string;
-    contentType: MessageContentType;
-    fromName: string | null;
-    fromEmail: string | null;
-    replyTo: string | null;
-    status: MessageStatus;
-    scheduledAt: string | null;
-    sentAt: string | null;
-    metadata: Record<string, any>;
-    totalRecipients: number;
-    recipientsSent: number;
-    recipientsDelivered: number;
-    recipientsOpened: number;
-    recipientsClicked: number;
-    recipientsBounced: number;
-    recipientsUnsubscribed: number;
-    openRate: number;
-    clickRate: number;
-    bounceRate: number;
-    errorMessage: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface MessageRecipient {
-    id: string;
-    recipientType: string;
-    recipientId: string | null;
-    recipientEmail: string;
-    recipientName: string | null;
-    channelIdentifier: string | null;
-    channelProfiles: Record<string, any>;
-    status: RecipientStatus;
-    sentAt: string | null;
-    deliveredAt: string | null;
-    bouncedAt: string | null;
-    firstOpenedAt: string | null;
-    lastOpenedAt: string | null;
-    firstClickedAt: string | null;
-    lastClickedAt: string | null;
-    openCount: number;
-    clickCount: number;
-    isUnsubscribed: boolean;
-    unsubscribedAt: string | null;
-    errorMessage: string | null;
-    createdAt: string;
-}
-interface MessagingChannel {
-    id: string;
-    key: string;
-    name: string;
-    description: string;
-    icon: string;
-    capabilities: {
-        maxContentLength: number;
-        supportsHtml: boolean;
-        supportsMarkdown: boolean;
-        supportsAttachments: boolean;
-        maxAttachments: number;
-        maxAttachmentSize: number;
-    };
-    requirements: {
-        requiresConnection: boolean;
-        requiresOptIn: boolean;
-        authRequirements: Record<string, any>;
-    };
-    rateLimit: {
-        messages: number;
-        seconds: number;
-        scope: string;
-        description: string;
-    };
-    metadata: Record<string, any>;
-}
-interface MessageFilters {
-    status?: MessageStatus;
-    contentType?: MessageContentType;
-    scheduledAfter?: string;
-    scheduledBefore?: string;
-    sentAfter?: string;
-    sentBefore?: string;
-    search?: string;
-    page?: number;
-    pageSize?: number;
-    ordering?: string;
-}
-interface CreateMessageInput {
-    channel: string;
-    subject: string;
-    body: string;
-    contentType?: MessageContentType;
-    fromName?: string;
-    fromEmail?: string;
-    replyTo?: string;
-    scheduledAt?: string;
-    metadata?: Record<string, any>;
-    recipients?: Array<{
-        recipientType: string;
-        recipientEmail: string;
-        recipientName?: string;
-        channelIdentifier?: string;
-    }>;
-}
-interface ScheduleMessageInput {
-    scheduledAt: string;
-}
-interface SendTestInput {
-    testEmail?: string;
-}
-declare class MessagesApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * List messages with optional filters
-     */
-    list(filters?: MessageFilters): Promise<{
-        results: Message[];
-        count: number;
-        next: string | null;
-        previous: string | null;
-    }>;
-    /**
-     * Get message by ID
-     */
-    get(id: string): Promise<Message>;
-    /**
-     * Create a new message
-     */
-    create(data: CreateMessageInput): Promise<Message>;
-    /**
-     * Update message (draft only)
-     */
-    update(id: string, data: Partial<CreateMessageInput>): Promise<Message>;
-    /**
-     * Delete message (draft only)
-     */
-    delete(id: string): Promise<unknown>;
-    /**
-     * Schedule message for future sending
-     */
-    schedule(id: string, input: ScheduleMessageInput): Promise<{
-        id: string;
-        status: MessageStatus;
-        scheduledAt: string;
-        message: string;
-    }>;
-    /**
-     * Send message immediately
-     */
-    sendNow(id: string): Promise<{
-        id: string;
-        status: MessageStatus;
-        message: string;
-    }>;
-    /**
-     * Send test message
-     */
-    sendTest(id: string, input?: SendTestInput): Promise<{
-        id: string;
-        testEmail: string;
-        message: string;
-    }>;
-    /**
-     * Preview message rendering
-     */
-    preview(id: string): Promise<{
-        subject: string;
-        body: string;
-        previewHtml: string;
-        fromName: string;
-        fromEmail: string;
-    }>;
-    /**
-     * List recipients for a message
-     */
-    getRecipients(id: string, page?: number, pageSize?: number): Promise<{
-        results: MessageRecipient[];
-        count: number;
-    }>;
-    /**
-     * Add recipients to a message
-     */
-    addRecipients(id: string, recipients: Array<{
-        recipientType: string;
-        recipientEmail: string;
-        recipientName?: string;
-        channelIdentifier?: string;
-    }>): Promise<{
-        message: string;
-        totalRecipients: number;
-        recipients: MessageRecipient[];
-    }>;
-    /**
-     * Get available messaging channels
-     */
-    getChannels(): Promise<{
-        channels: MessagingChannel[];
-        count: number;
-    }>;
-}
-
-/**
- * Funnels API wrapper for /api/v1/funnels/
- */
-
-/**
- * Returns true when the error is a 409 Conflict from trying to run a funnel that's already running.
- */
-declare function isFunnelRunConflict(error: unknown): boolean;
-/**
- * Returns true when the error is a 400 with validation errors (bad stage rules, missing entityType, etc.)
- */
-declare function isFunnelValidationError(error: unknown): boolean;
-interface FunnelPreviewResult {
-    total: number;
-    matched: number;
-    stages: Array<{
-        stageId: string;
-        stageName: string;
-        inputCount: number;
-        outputCount: number;
-        excluded: number;
-    }>;
-}
-interface FunnelRunFilters {
-    page?: number;
-    pageSize?: number;
-    status?: FunnelRun['status'];
-    ordering?: string;
-    funnel?: string;
-    startedAfter?: string;
-    startedBefore?: string;
-}
-interface FunnelTemplate {
-    id: string;
-    slug: string;
-    name: string;
-    description: string;
-    category: string;
-    icon: string;
-    isFeatured: boolean;
-    stageCount: number;
-    usageCount: number;
-}
-declare class FunnelsApi {
-    private client;
-    constructor(client: ApiClient);
-    /**
-     * List funnels with optional filters.
-     * Tags are passed as repeated query params: ?tags=campaign:abc&tags=product:market-simpli
-     */
-    list(filters?: FunnelFilters): Promise<PaginatedResponse<Funnel>>;
-    /**
-     * Get funnel by ID
-     */
-    get(id: string): Promise<Funnel>;
-    /**
-     * Create a new funnel
-     */
-    create(data: CreateFunnelInput): Promise<Funnel>;
-    /**
-     * Update funnel (partial)
-     */
-    update(id: string, data: UpdateFunnelInput): Promise<Funnel>;
-    /**
-     * Delete funnel
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Execute a funnel run
-     */
-    run(id: string, input?: ExecuteFunnelInput): Promise<FunnelRun>;
-    /**
-     * List run history for a funnel
-     */
-    getRuns(funnelId: string, filters?: FunnelRunFilters): Promise<PaginatedResponse<FunnelRun>>;
-    /**
-     * Get a specific run by ID. funnelId param is ignored (runs are accessed globally).
-     */
-    getRun(_funnelId: string, runId: string): Promise<FunnelRun>;
-    getResults(_funnelId: string, _pagination?: PaginationParams): Promise<PaginatedResponse<FunnelResult>>;
-    preview(_funnelId: string, _stages?: Funnel['stages']): Promise<FunnelPreviewResult>;
-    /**
-     * List all funnel runs globally (across all funnels, scoped to current user)
-     */
-    listRunsGlobal(filters?: FunnelRunFilters): Promise<PaginatedResponse<FunnelRun>>;
-    /**
-     * Cancel a running funnel run.
-     */
-    cancelRun(runId: string): Promise<FunnelRun>;
-    /**
-     * List available funnel templates
-     */
-    listTemplates(filters?: {
-        category?: string;
-        page?: number;
-        pageSize?: number;
-    }): Promise<PaginatedResponse<FunnelTemplate>>;
-}
-
-/**
- * API error handling and normalization
- */
-
-declare class ApiException extends Error {
-    status?: number;
-    statusText?: string;
-    errors?: Record<string, string[]>;
-    detail?: string;
-    constructor(message: string, options?: Partial<ApiError$1>);
-    toJSON(): ApiError$1;
-}
-/**
- * Parse Django REST Framework error response
- */
-declare function parseErrorResponse(response: Response): Promise<ApiError$1>;
-/**
- * Handle fetch errors
- */
-declare function handleFetchError(error: unknown): never;
-/**
- * Check if error is an API exception
- */
-declare function isApiException(error: unknown): error is ApiException;
-/**
- * Check if error is a validation error
- */
-declare function isValidationError(error: unknown): error is ApiException;
-/**
- * Check if error is an auth error
- */
-declare function isAuthError(error: unknown): error is ApiException;
-/**
- * Check if error is a not found error
- */
-declare function isNotFoundError(error: unknown): error is ApiException;
-
-/**
- * AppError hierarchy for StartSimpli apps
- *
- * Provides a standardized error hierarchy with:
- * - Consistent error codes and messages
- * - HTTP status code mapping
- * - Serialization for API responses
- *
- * These are server-side application errors (not API client fetch errors).
- * For API client errors see ./error-handler.ts (ApiException).
- */
-/**
- * Standard error codes used across the application
- */
-declare enum AppErrorCode {
-    VALIDATION_ERROR = "VALIDATION_ERROR",
-    AUTHENTICATION_REQUIRED = "AUTHENTICATION_REQUIRED",
-    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
-    SESSION_EXPIRED = "SESSION_EXPIRED",
-    FORBIDDEN = "FORBIDDEN",
-    INSUFFICIENT_PERMISSIONS = "INSUFFICIENT_PERMISSIONS",
-    NOT_FOUND = "NOT_FOUND",
-    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
-    CONFLICT = "CONFLICT",
-    DUPLICATE_RESOURCE = "DUPLICATE_RESOURCE",
-    RATE_LIMITED = "RATE_LIMITED",
-    BAD_REQUEST = "BAD_REQUEST",
-    INTERNAL_ERROR = "INTERNAL_ERROR",
-    DATABASE_ERROR = "DATABASE_ERROR",
-    EXTERNAL_SERVICE_ERROR = "EXTERNAL_SERVICE_ERROR",
-    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE"
-}
-/**
- * Shape of the error envelope returned from AppError.toResponse()
- */
-interface AppErrorResponse {
-    error: {
-        code: AppErrorCode;
-        message: string;
-        details?: Record<string, unknown>;
-    };
-}
-/**
- * Base application error class.
- * All custom errors should extend this class.
- */
-declare class AppError extends Error {
-    readonly code: AppErrorCode;
-    readonly statusCode: number;
-    readonly details?: Record<string, unknown>;
-    readonly isOperational: boolean;
-    constructor(message: string, code?: AppErrorCode, statusCode?: number, details?: Record<string, unknown>, isOperational?: boolean);
-    /**
-     * Serialize error for API response
-     */
-    toResponse(): AppErrorResponse;
-    /**
-     * Check if an error is an operational error (expected) vs programming error
-     */
-    static isOperationalError(error: unknown): error is AppError;
-}
-/**
- * Validation error for invalid request data
- * HTTP 400 Bad Request
- */
-declare class ValidationError extends AppError {
-    readonly fieldErrors: Record<string, string[]>;
-    constructor(message?: string, fieldErrors?: Record<string, string[]>);
-    /**
-     * Create from Zod error
-     */
-    static fromZodError(zodError: {
-        errors: Array<{
-            path: (string | number)[];
-            message: string;
-        }>;
-    }): ValidationError;
-}
-/**
- * Authentication error for unauthenticated requests
- * HTTP 401 Unauthorized
- */
-declare class AuthenticationError extends AppError {
-    constructor(message?: string, code?: AppErrorCode);
-    /**
-     * Create for invalid credentials
-     */
-    static invalidCredentials(): AuthenticationError;
-    /**
-     * Create for expired session
-     */
-    static sessionExpired(): AuthenticationError;
-}
-/**
- * Authorization error for forbidden access
- * HTTP 403 Forbidden
- */
-declare class AuthorizationError extends AppError {
-    constructor(message?: string, code?: AppErrorCode);
-    /**
-     * Create for insufficient permissions
-     */
-    static insufficientPermissions(requiredPermission?: string): AuthorizationError;
-}
-/**
- * Not found error for missing resources
- * HTTP 404 Not Found
- */
-declare class NotFoundError extends AppError {
-    readonly resourceType?: string;
-    readonly resourceId?: string;
-    constructor(message?: string, resourceType?: string, resourceId?: string);
-    /**
-     * Create for a specific resource
-     */
-    static forResource(resourceType: string, resourceId?: string): NotFoundError;
-}
-/**
- * Conflict error for duplicate or conflicting resources
- * HTTP 409 Conflict
- */
-declare class ConflictError extends AppError {
-    readonly conflictingField?: string;
-    constructor(message?: string, conflictingField?: string);
-    /**
-     * Create for duplicate resource
-     */
-    static duplicate(resourceType: string, field?: string): ConflictError;
-}
-/**
- * Rate limit error for too many requests
- * HTTP 429 Too Many Requests
- */
-declare class RateLimitError extends AppError {
-    readonly retryAfter?: number;
-    constructor(message?: string, retryAfter?: number);
-}
-/**
- * Database error for database-related failures
- * HTTP 500 Internal Server Error
- */
-declare class DatabaseError extends AppError {
-    constructor(message?: string, details?: Record<string, unknown>);
-    /**
-     * Create from Prisma error
-     */
-    static fromPrismaError(error: {
-        code?: string;
-        meta?: Record<string, unknown>;
-    }): DatabaseError;
-}
-/**
- * External service error for third-party API failures
- * HTTP 502 Bad Gateway
- */
-declare class ExternalServiceError extends AppError {
-    readonly serviceName: string;
-    constructor(serviceName: string, message?: string, details?: Record<string, unknown>);
-}
-/**
- * Type guard to check if an error has a code property (like Prisma errors)
- */
-declare function isPrismaError(error: unknown): error is {
-    code: string;
-    meta?: Record<string, unknown>;
-};
-/**
- * Convert any error to an AppError.
- * Useful for catch blocks to ensure consistent error handling.
- */
-declare function toAppError(error: unknown): AppError;
-
-/**
- * XSS Protection - sanitize HTML content
- *
- * Strips all tags except a safe allowlist and removes dangerous attributes.
- */
-declare function sanitizeHtml(input: string): string;
-/**
- * Validate and sanitize a search query string.
- *
- * Trims whitespace, escapes regex special characters, and limits length to 100 chars.
- */
-declare function sanitizeSearchQuery(query: string): string;
-/**
- * Validate that a string is a safe SQL/API identifier.
- *
- * Only allows alphanumeric characters, underscores, and hyphens.
- */
-declare function validateIdentifier(input: string): boolean;
-
-/**
- * Input Sanitization for LLM Prompts
- *
- * Provides protection against prompt injection attacks by sanitizing
- * user input before including it in LLM prompts.
- */
-/**
- * Maximum allowed length for user prompts (characters)
- */
-declare const MAX_PROMPT_LENGTH = 2000;
-/**
- * Maximum allowed length for chat messages (characters)
- */
-declare const MAX_CHAT_MESSAGE_LENGTH = 1000;
-/**
- * Sanitize user input for inclusion in LLM prompts
- *
- * @param input - Raw user input
- * @param maxLength - Maximum allowed length (defaults to MAX_PROMPT_LENGTH)
- * @returns Sanitized input safe for prompt inclusion
- */
-declare function sanitizeUserInput(input: string, maxLength?: number): string;
-/**
- * Sanitize chat message input (shorter limit, same rules)
- */
-declare function sanitizeChatMessage(input: string): string;
-
-/**
- * CORS utilities for Next.js API routes
- *
- * Framework-agnostic header generation with an optional Next.js
- * middleware wrapper for apps that need it.
- */
-interface CorsOptions {
-    /** Allowed origins. Use '*' for wildcard. */
-    origins: string[] | '*';
-    /** Allowed HTTP methods. Defaults to common REST methods. */
-    methods?: string[];
-    /** Allowed request headers. Defaults to common headers. */
-    headers?: string[];
-    /** Whether to allow credentials. Defaults to true when origins is a list. */
-    credentials?: boolean;
-    /** Preflight cache duration in seconds. Defaults to 86400 (24h). */
-    maxAge?: number;
-}
-/**
- * Build the CORS headers for a given request origin.
- *
- * Returns an empty object when the origin is not permitted so callers
- * can decide whether to reject or silently omit the headers.
- */
-declare function getCorsHeaders(origin: string | null | undefined, options: CorsOptions): Record<string, string>;
-/**
- * Apply CORS headers to an existing Headers object in-place.
- */
-declare function applyCorsHeaders(responseHeaders: Headers, origin: string | null | undefined, options: CorsOptions): void;
-/**
- * Create a CORS middleware function for use in Next.js middleware.ts files.
- *
- * Returns a function that accepts a Request and returns a Response (for
- * preflight OPTIONS) or null (for all other requests, letting the chain
- * continue after headers are applied via getCorsHeaders).
- *
- * Usage in middleware.ts:
- *
- * ```ts
- * import { createCorsMiddleware } from '@startsimpli/api';
- * import { NextResponse } from 'next/server';
- *
- * const corsMiddleware = createCorsMiddleware({
- *   origins: [process.env.NEXT_PUBLIC_BASE_URL ?? 'http://localhost:3000'],
- * });
- *
- * export function middleware(request: Request) {
- *   const preflightResponse = corsMiddleware(request);
- *   if (preflightResponse) return preflightResponse;
- *
- *   const response = NextResponse.next();
- *   const origin = request.headers.get('origin');
- *   applyCorsHeaders(response.headers, origin, corsOptions);
- *   return response;
- * }
- * ```
- */
-declare function createCorsMiddleware(options: CorsOptions): (request: Request) => Response | null;
-
-/**
- * In-memory rate limiter for Next.js API routes.
- *
- * Fixed-window counter with periodic cleanup.
- * Resets on server restart and does not share state across multiple instances.
- * For multi-instance production use, back the store with Redis/Upstash instead.
- */
-interface RateLimitOptions {
-    /** Duration of the rate limit window in milliseconds */
-    windowMs: number;
-    /** Maximum number of requests allowed per window */
-    maxRequests: number;
-    /** Optional prefix for keys (useful when sharing a single limiter across routes) */
-    keyPrefix?: string;
-}
-interface RateLimitResult {
-    /** Whether the request is within the allowed limit */
-    success: boolean;
-    /** Requests remaining in the current window */
-    remaining: number;
-    /** Timestamp (ms since epoch) when the current window resets */
-    resetAt: number;
-    /** Seconds to wait before retrying, present only when success is false */
-    retryAfter?: number;
-}
-/**
- * Factory that returns a rate-check function backed by an isolated in-memory store.
- *
- * @example
- * const check = createRateLimiter({ windowMs: 60_000, maxRequests: 10 });
- * const result = check('user:123');
- * if (!result.success) { // respond 429 }
- */
-declare function createRateLimiter(options: RateLimitOptions): (key: string) => RateLimitResult;
-/**
- * Extract the client IP address from a Web API Request or NextRequest.
- * Respects x-forwarded-for and x-real-ip proxy headers.
- */
-declare function getClientIP(request: Request): string;
-
-/**
- * In-memory LRU cache store with TTL expiry.
- *
- * A minimal, zero-dependency cache for server-side caching in Next.js apps.
- * State is in-memory and resets on server restart — not suitable for
- * multi-instance production deployments without a shared backend (e.g. Redis).
- */
-interface CacheStoreConfig {
-    /** Maximum number of entries before LRU eviction (default: 1000) */
-    maxSize: number;
-    /** Default TTL in milliseconds (default: 60 seconds) */
-    defaultTTL: number;
-}
-declare class CacheStore<T = unknown> {
-    private cache;
-    private config;
-    private hits;
-    private misses;
-    private accessCounter;
-    constructor(config?: Partial<CacheStoreConfig>);
-    get(key: string): T | undefined;
-    set(key: string, value: T, ttl?: number): void;
-    has(key: string): boolean;
-    delete(key: string): boolean;
-    /** Delete all keys matching a string prefix or RegExp pattern */
-    deletePattern(pattern: string | RegExp): number;
-    clear(): void;
-    /** Remove expired entries and return count removed */
-    cleanup(): number;
-    getStats(): {
-        size: number;
-        maxSize: number;
-        hits: number;
-        misses: number;
-        hitRate: number;
-    };
-    private evictLRU;
-}
-
-/**
- * Cache manager built on top of CacheStore.
- *
- * Provides a cache-aside pattern (getOrSet), pattern-based invalidation,
- * and separate entity/query stores — ready for use in Next.js API routes
- * and server-side data fetching.
- */
-
-interface CacheManagerConfig {
-    entity?: Partial<CacheStoreConfig>;
-    query?: Partial<CacheStoreConfig>;
-}
-declare class CacheManager {
-    readonly entity: CacheStore;
-    readonly query: CacheStore;
-    private enabled;
-    constructor(enabled?: boolean, config?: CacheManagerConfig);
-    /**
-     * Cache-aside: return the cached value if present, otherwise call fetchFn,
-     * store the result, and return it.
-     */
-    getOrSet<T>(key: string, ttlMs: number, fetchFn: () => Promise<T>): Promise<T>;
-    /** Invalidate a specific key in the query cache */
-    invalidateKey(key: string): void;
-    /** Invalidate all query cache keys matching a string prefix or RegExp */
-    invalidatePattern(pattern: string | RegExp): void;
-    /** Invalidate all entity and query cache entries for the given prefix */
-    invalidateAll(prefix: string): void;
-    setEnabled(enabled: boolean): void;
-    isEnabled(): boolean;
-    /** Remove expired entries from both stores */
-    maintenance(): {
-        entityRemoved: number;
-        queryRemoved: number;
-    };
-    clear(): void;
-    getStats(): {
-        entity: ReturnType<CacheStore['getStats']>;
-        query: ReturnType<CacheStore['getStats']>;
-    };
-}
-declare function getCacheManager(config?: CacheManagerConfig): CacheManager;
-declare function resetCacheManager(): void;
-
-/**
- * URL construction utilities for Django REST API
- */
-interface UrlBuilderOptions {
-    baseUrl: string;
-    endpoint: string;
-    params?: Record<string, unknown>;
-    id?: string | number;
-}
-/**
- * Build API URL with query parameters
- */
-declare function buildUrl({ baseUrl, endpoint, params, id }: UrlBuilderOptions): string;
-/**
- * Build query string from params object
- */
-declare function buildQueryString(params: Record<string, unknown>): string;
-/**
- * Resolve a full or partial API path to a final URL.
- *
- * Handles four cases:
- * - Absolute input URL → returned unchanged
- * - Absolute baseUrl  → joined via URL constructor
- * - Relative baseUrl  → string concatenation
- * - Empty / undefined baseUrl → path returned as-is (suits Next.js proxy pattern)
- */
-declare function resolveApiUrl(path: string, baseUrl?: string): string;
-/**
- * Extract ID from URL or return as-is
- */
-declare function normalizeId(id: string | number): string | number;
-
-/**
- * Django query parameter helpers
- */
-
-interface DjangoFilterParams extends PaginationParams, SortParams {
-    search?: string;
-    [key: string]: unknown;
-}
-/**
- * Build Django filter params from filters object
- */
-declare function buildFilterParams<T extends Record<string, unknown>>(filters: T): Record<string, unknown>;
-/**
- * Build Django ordering param from sort config
- */
-declare function buildOrderingParam(field?: string, direction?: 'asc' | 'desc'): string | undefined;
-/**
- * Merge pagination, sorting, and filter params
- */
-declare function mergeQueryParams(pagination?: PaginationParams, sorting?: SortParams, filters?: Record<string, unknown>): Record<string, unknown>;
-
-/**
- * Runtime API response validation
- *
- * Validates responses against Zod schemas but NEVER throws.
- * On mismatch: logs a warning, returns original data cast to expected type.
- * Schema drift should not crash the app.
- */
-
-/**
- * Validate an API response against a Zod schema.
- *
- * - On success: returns parsed (cleaned) data
- * - On failure: logs a warning with `context` label, returns the raw data
- *   cast as T. **The return value is NOT guaranteed to satisfy T on
- *   validation failure** — callers must tolerate schema drift at runtime.
- *
- * This is intentional — schema drift should degrade gracefully,
- * not crash the app. Pass a unique `context` string so mismatches
- * can be traced in logs (e.g. `"contacts.list"`, `"campaigns.get"`).
- */
-declare function validateApiResponse<T>(data: unknown, schema: z.ZodSchema<T>, context?: string): T;
-
-/**
- * Generic Entity Query Builder
- *
- * Builds server-side query parameters for entity filtering.
- * Supports tags, metrics, profiles, attributes, pagination, search, sorting, and date ranges.
- *
- * Usage:
- *   const params = new EntityQueryBuilder()
- *     .withTags('quality:tier_1', 'status:prospect')
- *     .withMetrics('financial:aum__gte:100000000')
- *     .paginate(1, 25)
- *     .search('acme')
- *     .sort('name', 'asc')
- *     .build()
- */
-declare class EntityQueryBuilder {
-    private params;
-    /**
-     * Filter by entity type
-     */
-    entityType(type: 'CONTACT' | 'ORGANIZATION'): this;
-    /**
-     * Add tag filters (compact format: "category:name")
-     *
-     * @example
-     * .withTags('quality:tier_1', 'status:prospect')
-     * // produces: tags=quality:tier_1,status:prospect
-     */
-    withTags(...tags: string[]): this;
-    /**
-     * Add metric filters (compact format: "type:subtype__operator:value")
-     *
-     * @example
-     * .withMetrics('financial:aum__gte:100000000', 'check_size:min__gte:1000000')
-     */
-    withMetrics(...metrics: string[]): this;
-    /**
-     * Add profile filters (compact format: "type:subtype")
-     *
-     * @example
-     * .withProfiles('professional:linkedin', 'social:twitter')
-     */
-    withProfiles(...profiles: string[]): this;
-    /**
-     * Add attribute filters (compact format: "type:subtype:value")
-     *
-     * @example
-     * .withAttributes('demographic:location:san_francisco')
-     */
-    withAttributes(...attrs: string[]): this;
-    /**
-     * Set pagination parameters
-     */
-    paginate(page: number, pageSize: number): this;
-    /**
-     * Set search query
-     */
-    search(query: string): this;
-    /**
-     * Set sort field and direction (maps to Django's `ordering` param)
-     */
-    sort(field: string, direction?: 'asc' | 'desc'): this;
-    /**
-     * Add a date range filter on a given field
-     *
-     * @example
-     * .withDateRange('created', new Date('2024-01-01'), new Date('2024-12-31'))
-     * // produces: created_after=2024-01-01&created_before=2024-12-31
-     */
-    withDateRange(field: string, from?: Date, to?: Date): this;
-    /**
-     * Set an arbitrary query parameter
-     */
-    param(key: string, value: string): this;
-    /**
-     * Build as a plain object (suitable for URLSearchParams or fetch helpers)
-     */
-    build(): Record<string, string>;
-    /**
-     * Build as a query string (includes leading `?`)
-     * Returns empty string if no params.
-     */
-    toQueryString(): string;
-    /**
-     * Reset all parameters
-     */
-    clear(): this;
-}
-
-/**
- * Django REST Framework response transformations
- *
- * Normalizes DRF paginated responses into a frontend-friendly shape.
- */
-/**
- * Raw DRF paginated response shape
- */
-interface DRFPaginatedResponse<T> {
-    count: number;
-    next: string | null;
-    previous: string | null;
-    results: T[];
-}
-/**
- * Normalized paginated response for frontend consumption
- */
-interface NormalizedPaginatedResponse<T> {
-    items: T[];
-    total: number;
-    page: number;
-    pageSize: number;
-    hasNext: boolean;
-    hasPrev: boolean;
-}
-/**
- * Normalize a DRF paginated response into a frontend-friendly format.
- *
- * @param response - Raw DRF paginated response
- * @param page - Current page number (1-based)
- * @param pageSize - Items per page
- */
-declare function normalizePaginated<T>(response: DRFPaginatedResponse<T>, page: number, pageSize: number): NormalizedPaginatedResponse<T>;
-/**
- * Check if a response is a DRF paginated response
- */
-declare function isDRFPaginatedResponse<T = unknown>(response: unknown): response is DRFPaginatedResponse<T>;
-
-/**
- * Django REST API endpoint constants
- */
-declare const ENDPOINTS: {
-    readonly CONTACTS: "contacts";
-    readonly CONTACTS_BULK: "contacts/bulk";
-    readonly CONTACT: (id: string) => string;
-    readonly ORGANIZATIONS: "organizations";
-    readonly ORGANIZATIONS_BULK: "organizations/bulk";
-    readonly ORGANIZATION: (id: string) => string;
-    readonly TAGS: "core/tags";
-    readonly TAG: (id: string) => string;
-    readonly ENTITY_TAGS: "core/entity-tags";
-    readonly ENTITY_TAG: (id: string) => string;
-    readonly METRICS: "core/metrics";
-    readonly METRIC: (id: string) => string;
-    readonly PROFILES: "core/profiles";
-    readonly PROFILE: (id: string) => string;
-    readonly ATTRIBUTES: "core/attributes";
-    readonly ATTRIBUTE: (id: string) => string;
-    readonly RELATIONSHIPS: "core/relationships";
-    readonly RELATIONSHIP: (id: string) => string;
-    readonly WORKFLOWS: "workflows";
-    readonly WORKFLOW: (id: string) => string;
-    readonly WORKFLOW_EXECUTE: (id: string) => string;
-    readonly MESSAGES: "messages";
-    readonly MESSAGE: (id: string) => string;
-    readonly MESSAGE_SEND: (id: string) => string;
-    readonly FUNNELS: "funnels";
-    readonly FUNNEL: (id: string) => string;
-    readonly FUNNEL_RUN: (id: string) => string;
-    readonly FUNNEL_RUNS: (id: string) => string;
-    readonly FUNNEL_RUN_ITEM: (funnelId: string, runId: string) => string;
-    readonly FUNNEL_PREVIEW: (id: string) => string;
-    readonly FUNNEL_RESULTS: (id: string) => string;
-    readonly FUNNEL_TEMPLATES: "funnels/templates";
-    readonly FUNNEL_RUN_BY_ID: (runId: string) => string;
-    readonly FUNNEL_RUN_CANCEL: (runId: string) => string;
-    readonly FUNNEL_RUNS_GLOBAL: "funnel-runs";
-};
-
-/**
- * Shared CRM option constants for dropdown fields.
- *
- * Used across market-simpli and raise-simpli for company/contact field dropdowns.
- */
-interface SelectOption<T extends string = string> {
-    value: T;
-    label: string;
-}
-declare const COMPANY_SIZE_OPTIONS: [{
-    readonly value: "startup";
-    readonly label: "Startup (1-10)";
-}, {
-    readonly value: "small";
-    readonly label: "Small (11-50)";
-}, {
-    readonly value: "smb";
-    readonly label: "SMB (51-200)";
-}, {
-    readonly value: "mid_market";
-    readonly label: "Mid-Market (201-1000)";
-}, {
-    readonly value: "enterprise";
-    readonly label: "Enterprise (1000+)";
-}];
-declare const LIFECYCLE_STAGE_OPTIONS: [{
-    readonly value: "subscriber";
-    readonly label: "Subscriber";
-}, {
-    readonly value: "lead";
-    readonly label: "Lead";
-}, {
-    readonly value: "mql";
-    readonly label: "MQL";
-}, {
-    readonly value: "sql";
-    readonly label: "SQL";
-}, {
-    readonly value: "opportunity";
-    readonly label: "Opportunity";
-}, {
-    readonly value: "customer";
-    readonly label: "Customer";
-}, {
-    readonly value: "evangelist";
-    readonly label: "Evangelist";
-}];
-declare const REVENUE_RANGE_OPTIONS: [{
-    readonly value: "pre_revenue";
-    readonly label: "Pre-revenue";
-}, {
-    readonly value: "0_1m";
-    readonly label: "$0-$1M";
-}, {
-    readonly value: "1m_10m";
-    readonly label: "$1M-$10M";
-}, {
-    readonly value: "10m_50m";
-    readonly label: "$10M-$50M";
-}, {
-    readonly value: "50m_plus";
-    readonly label: "$50M+";
-}];
-declare const ACTIVITY_TYPE_OPTIONS: [{
-    readonly value: "call";
-    readonly label: "Call";
-}, {
-    readonly value: "email";
-    readonly label: "Email";
-}, {
-    readonly value: "meeting";
-    readonly label: "Meeting";
-}, {
-    readonly value: "demo";
-    readonly label: "Demo";
-}, {
-    readonly value: "note";
-    readonly label: "Note";
-}, {
-    readonly value: "task";
-    readonly label: "Task";
-}];
-declare const ACTIVITY_OUTCOME_OPTIONS: [{
-    readonly value: "scheduled_demo";
-    readonly label: "Scheduled Demo";
-}, {
-    readonly value: "scheduled_meeting";
-    readonly label: "Scheduled Meeting";
-}, {
-    readonly value: "callback_later";
-    readonly label: "Callback Later";
-}, {
-    readonly value: "left_voicemail";
-    readonly label: "Left Voicemail";
-}, {
-    readonly value: "no_answer";
-    readonly label: "No Answer";
-}, {
-    readonly value: "not_interested";
-    readonly label: "Not Interested";
-}, {
-    readonly value: "successful";
-    readonly label: "Successful";
-}, {
-    readonly value: "unsuccessful";
-    readonly label: "Unsuccessful";
-}];
-declare const LOSS_REASON_OPTIONS: [{
-    readonly value: "price";
-    readonly label: "Price / Budget";
-}, {
-    readonly value: "timing";
-    readonly label: "Bad Timing";
-}, {
-    readonly value: "competitor";
-    readonly label: "Chose Competitor";
-}, {
-    readonly value: "no_need";
-    readonly label: "No Need";
-}, {
-    readonly value: "no_response";
-    readonly label: "No Response";
-}, {
-    readonly value: "other";
-    readonly label: "Other";
-}];
-declare const DEAL_STAGE_OPTIONS: [{
-    readonly value: "qualification";
-    readonly label: "Qualification";
-}, {
-    readonly value: "discovery";
-    readonly label: "Discovery";
-}, {
-    readonly value: "demo";
-    readonly label: "Demo";
-}, {
-    readonly value: "proposal";
-    readonly label: "Proposal";
-}, {
-    readonly value: "negotiation";
-    readonly label: "Negotiation";
-}, {
-    readonly value: "closed_won";
-    readonly label: "Closed Won";
-}, {
-    readonly value: "closed_lost";
-    readonly label: "Closed Lost";
-}];
-type CompanySize = (typeof COMPANY_SIZE_OPTIONS)[number]['value'];
-type LifecycleStage = (typeof LIFECYCLE_STAGE_OPTIONS)[number]['value'];
-type RevenueRange = (typeof REVENUE_RANGE_OPTIONS)[number]['value'];
-type ActivityType = (typeof ACTIVITY_TYPE_OPTIONS)[number]['value'];
-type ActivityOutcome = (typeof ACTIVITY_OUTCOME_OPTIONS)[number]['value'];
-type LossReason = (typeof LOSS_REASON_OPTIONS)[number]['value'];
-type DealStage = (typeof DEAL_STAGE_OPTIONS)[number]['value'];
-
-interface ServerListOptions {
-    pageSize?: number;
-    initialPage?: number;
-    initialSearch?: string;
-    initialSortField?: string;
-    initialSortDir?: 'asc' | 'desc';
-    /** Extra static query params to append on every request */
-    params?: Record<string, string | number | boolean>;
-    /** Disable auto-fetch on mount */
-    disabled?: boolean;
-    /** Custom fetch function (defaults to global fetch). Use authFetch from @startsimpli/auth for authenticated calls. */
-    fetcher?: typeof fetch;
-}
-interface ServerListResult<T> {
-    data: T[];
-    total: number;
-    loading: boolean;
-    error: string | null;
-    page: number;
-    pageSize: number;
-    search: string;
-    sortField: string;
-    sortDir: 'asc' | 'desc';
-    setPage: (page: number) => void;
-    setPageSize: (size: number) => void;
-    setSearch: (search: string) => void;
-    setSort: (field: string, dir?: 'asc' | 'desc') => void;
-    refresh: () => void;
-}
-/**
- * Hook for server-side paginated list fetching.
- * Sends ?page=N&pageSize=Y&sortField=Z&sortDirection=asc|desc&search=Q
- * to the provided endpoint.
- *
- * @example
- * import { useServerList } from '@startsimpli/api'
- * import { authFetch } from '@startsimpli/auth'
- *
- * const { data, total, loading, page, setPage, setSearch } = useServerList<Email>(
- *   '/api/v1/emails/',
- *   { fetcher: authFetch, pageSize: 25 }
- * )
- */
-declare function useServerList<T>(endpoint: string, options?: ServerListOptions): ServerListResult<T>;
-
-interface ServerDetailOptions {
-    /** Custom fetch function. Use authFetch from @startsimpli/auth for authenticated calls. */
-    fetcher?: typeof fetch;
-    /** Pass null to skip fetching (e.g., when ID is not yet known) */
-    disabled?: boolean;
-}
-interface ServerDetailResult<T> {
-    data: T | null;
-    loading: boolean;
-    error: string | null;
-    refresh: () => void;
-}
-/**
- * Hook for fetching a single resource.
- *
- * @example
- * import { useServerDetail } from '@startsimpli/api'
- * import { authFetch } from '@startsimpli/auth'
- *
- * const { data, loading, error } = useServerDetail<User>(
- *   '/api/v1/users/',
- *   userId,
- *   { fetcher: authFetch }
- * )
- */
-declare function useServerDetail<T>(endpoint: string, id?: string | number | null, options?: ServerDetailOptions): ServerDetailResult<T>;
-
-/**
- * Environment variable utilities for server-side use.
- *
- * These are generic helpers for accessing process.env safely.
- * App-specific schema validation (via zod) lives in each app's src/lib/env.ts.
- */
-/**
- * Returns the value of an environment variable, throwing if it is missing or empty.
- */
-declare function getRequiredEnv(key: string): string;
-/**
- * Returns the value of an environment variable, or a default if it is missing.
- */
-declare function getOptionalEnv(key: string, defaultValue?: string): string | undefined;
-/**
- * Asserts that all listed environment variable keys are present and non-empty.
- * Throws a single error listing every missing variable instead of failing on the first one.
- */
-declare function validateEnvVars(required: string[]): void;
-
-/**
- * Create a complete API client with all endpoints.
- * All config fields are optional — baseUrl defaults to '' (relative URLs via Next.js proxy).
- */
-declare function createStartSimpliApi(config?: ApiClientConfig): {
-    client: ApiClient;
-    contacts: ContactsApi;
-    organizations: OrganizationsApi;
-    entities: EntitiesApi;
-    workflows: WorkflowsApi;
-    messages: MessagesApi;
-    funnels: FunnelsApi;
-};
-
-export { ACTIVITY_OUTCOME_OPTIONS, ACTIVITY_TYPE_OPTIONS, type ActivityOutcome, type ActivityType, ApiClient, type ApiClientConfig, type ApiError, ApiException, type ApiRequestConfig, type ApiResponse, AppError, AppErrorCode, type AppErrorResponse, type AsyncState, type AsyncStatus, type Attribute, AuthenticationError, AuthorizationError, COMPANY_SIZE_OPTIONS, CacheManager, type CacheManagerConfig, CacheStore, type CacheStoreConfig, type CompanySize, ConflictError, type Contact, type ContactFilters, ContactsApi, type CorsOptions, type CreateContactRequest, type CreateFunnelInput, type CreateOrganizationRequest, type CreateWorkflowInput$1 as CreateWorkflowInput, DEAL_STAGE_OPTIONS, type ApiError$1 as DRFApiError, type DRFPaginatedResponse, DatabaseError, type DealStage, type DjangoFilterParams, ENDPOINTS, EntitiesApi, type Entity, EntityQueryBuilder, type EntityTag, type EntityType$1 as EntityType, ErrorCode, ErrorCodes, ErrorMessages, type Event, type EventParticipant, type ExecuteFunnelInput, type ExecuteWorkflowInput$1 as ExecuteWorkflowInput, ExternalServiceError, type FetchOptions, FetchWrapper, type FetchWrapperConfig, type FieldError, FieldErrorSchema, type Funnel, type FunnelFilters, type FunnelPreviewResult, type FunnelResult, type FunnelRun, type FunnelRunFilters, type FunnelStage, type FunnelStageRule, type FunnelStatus, type FunnelTemplate, FunnelsApi, type HttpMethod, LIFECYCLE_STAGE_OPTIONS, LOSS_REASON_OPTIONS, type LifecycleStage, type LossReason, MAX_CHAT_MESSAGE_LENGTH, MAX_PROMPT_LENGTH, type Message, type MessageStatus as MessageApiStatus, type MessageRecipient, MessagesApi, type MessagingChannel as MessagingChannelType, type Metric, type NormalizedPaginatedResponse, NotFoundError, type Organization, type OrganizationFilters, OrganizationsApi, type PaginatedResponse, type PaginationParams, type Profile, REVENUE_RANGE_OPTIONS, RateLimitError, type RateLimitOptions, type RateLimitResult, type Relationship, type RevenueRange, type RoleAssignment, type SelectOption, type ServerDetailResult, type ServerListOptions, type ServerListResult, type SortParams, type Source, type StandardErrorResponse, StandardErrorResponseSchema, type Tag, type UpdateContactRequest, type UpdateFunnelInput, type UpdateOrganizationRequest, type UpdateWorkflowInput, type UrlBuilderOptions, ValidationError, type Workflow$1 as Workflow, type WorkflowExecution$1 as WorkflowExecution, type WorkflowFilters$1 as WorkflowFilters, type WorkflowStatus, WorkflowsApi, type WritableAssertions, applyCorsHeaders, buildFilterParams, buildOrderingParam, buildQueryString, buildUrl, createApiClient, createCorsMiddleware, createRateLimiter, createStartSimpliApi, getCacheManager, getClientIP, getCorsHeaders, getErrorCodeFromStatus, getOptionalEnv, getRequiredEnv, handleFetchError, isApiException, isAuthError, isDRFPaginatedResponse, isFunnelRunConflict, isFunnelValidationError, isNotFoundError, isPrismaError, isValidationError, mergeQueryParams, normalizeId, normalizePaginated, parseErrorResponse, resetCacheManager, resolveApiUrl, sanitizeChatMessage, sanitizeHtml, sanitizeSearchQuery, sanitizeUserInput, toAppError, useServerDetail, useServerList, validateApiResponse, validateEnvVars, validateIdentifier };