@igorchugurov/public-api-sdk 1.0.0

package/dist/client-DqqjGYgA.d.ts

@@ -0,0 +1,1175 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Типы для UI конфигурации сущностей
+ * Единый источник истины для UI типов в SDK
+ *
+ * Эти типы используются для автоматической генерации:
+ * - Страниц списков (list pages)
+ * - Страниц редактирования/создания (form pages)
+ * - UI элементов (кнопки, сообщения, модалки)
+ */
+interface ListPageConfig {
+    pageTitle: string;
+    searchPlaceholder?: string;
+    emptyStateTitle: string;
+    emptyStateMessages: string[];
+    showCreateButton: boolean;
+    createButtonText: string;
+    showSearch: boolean;
+    enablePagination: boolean;
+    pageSize?: number;
+    enableFilters: boolean;
+    searchableFields?: string[];
+    columns: ColumnConfig[];
+}
+interface ColumnConfig {
+    field: string;
+    headerName: string;
+    width?: number;
+    flex?: number;
+    type?: "text" | "date" | "number" | "boolean" | "naigateToDetails" | "openEditPage" | "actions" | "relation";
+    sortable?: boolean;
+    relationDbType?: "manyToOne" | "oneToOne" | "manyToMany" | "oneToMany";
+    actions?: ActionConfig[];
+    additionalUrl?: string;
+}
+interface ActionConfig {
+    action: "edit" | "delete" | "view" | "clone" | "copy" | "link";
+    icon?: string;
+    link?: boolean;
+    additionalUrl?: string;
+    label?: string;
+    /**
+     * Условие для скрытия action на основе данных строки
+     * Если значение поля `field` равно `value`, action скрывается
+     */
+    hideIf?: {
+        field: string;
+        value: string | number | boolean;
+    };
+}
+interface FormPageConfig {
+    createPageTitle: string;
+    editPageTitle: string;
+    pageHeader?: string;
+    createButtonLabel: string;
+    updateButtonLabel: string;
+    cancelButtonLabel?: string;
+    sectionTitles?: {
+        0?: string;
+        1?: string;
+        2?: string;
+        3?: string;
+    };
+}
+interface MessagesConfig {
+    afterCreate: string;
+    afterUpdate: string;
+    afterDelete: string;
+    errorCreate?: string;
+    errorUpdate?: string;
+    deleteModalTitle: string;
+    deleteModalText: string;
+    deleteModalConfirmWord?: string;
+    deleteModalConfirmText?: string;
+    deleteModalButtonText: string;
+    reloadEvents: {
+        create: string;
+        update: string;
+        delete: string;
+    };
+}
+interface EntityUIConfig {
+    list: ListPageConfig;
+    form: FormPageConfig;
+    messages: MessagesConfig;
+    apiUrl: string;
+    apiUrlAll?: string;
+}
+/**
+ * Partial UI конфиг для хранения в БД (uiConfig JSONB поле)
+ * Позволяет переопределить только нужные значения
+ */
+type PartialUIConfig = {
+    list?: Partial<Omit<ListPageConfig, "columns">> & {
+        columns?: Partial<ColumnConfig>[];
+    };
+    form?: Partial<FormPageConfig>;
+    messages?: Partial<MessagesConfig>;
+    apiUrl?: string;
+    apiUrlAll?: string;
+};
+
+/**
+ * Типы для универсальной системы сущностей
+ * Единый источник истины для типов сущностей в SDK
+ */
+
+interface EntityDefinition {
+    id: string;
+    name: string;
+    description?: string | null;
+    tableName: string;
+    type: "primary" | "secondary" | "tertiary";
+    projectId: string;
+    createPermission: "ALL" | "User" | "Admin" | "Admin|User" | "Owner" | "Owner|Admin" | "Owner|User";
+    readPermission: "ALL" | "User" | "Admin" | "Admin|User" | "Owner" | "Owner|Admin" | "Owner|User";
+    updatePermission: "ALL" | "User" | "Admin" | "Admin|User" | "Owner" | "Owner|Admin" | "Owner|User";
+    deletePermission: "ALL" | "User" | "Admin" | "Admin|User" | "Owner" | "Owner|Admin" | "Owner|User";
+    titleSection0?: string | null;
+    titleSection1?: string | null;
+    titleSection2?: string | null;
+    titleSection3?: string | null;
+    uiConfig?: PartialUIConfig | null;
+    enablePagination?: boolean | null;
+    pageSize?: number | null;
+    enableFilters?: boolean | null;
+    maxFileSizeMb?: number | null;
+    maxFilesCount?: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+type FieldType = "select" | "text" | "textarea" | "number" | "date" | "boolean" | "radio" | "multipleSelect" | "array" | "dynamicValue" | "files" | "images";
+type DbType = "varchar" | "float" | "boolean" | "timestamptz" | "manyToOne" | "oneToMany" | "manyToMany" | "oneToOne" | "files";
+interface FieldOption {
+    id: string;
+    name: string;
+}
+interface Field {
+    id: string;
+    entityDefinitionId: string;
+    name: string;
+    dbType: DbType;
+    type: FieldType;
+    label: string;
+    placeholder?: string | null;
+    description?: string | null;
+    forEditPage: boolean;
+    forCreatePage: boolean;
+    required: boolean;
+    requiredText?: string | null;
+    forEditPageDisabled: boolean;
+    displayIndex: number;
+    displayInTable: boolean;
+    sectionIndex: number;
+    isOptionTitleField: boolean;
+    searchable: boolean;
+    filterableInList?: boolean;
+    options?: FieldOption[];
+    relatedEntityDefinitionId?: string | null;
+    relationFieldId?: string | null;
+    isRelationSource: boolean;
+    selectorRelationId?: string | null;
+    relationFieldName?: string | null;
+    relationFieldLabel?: string | null;
+    defaultStringValue?: string | null;
+    defaultNumberValue?: number | null;
+    defaultBooleanValue?: boolean | null;
+    defaultDateValue?: string | null;
+    autoPopulate: boolean;
+    includeInSinglePma: boolean;
+    includeInListPma: boolean;
+    includeInSingleSa: boolean;
+    includeInListSa: boolean;
+    foreignKey?: string | null;
+    foreignKeyValue?: string | null;
+    typeFieldName?: string | null;
+    optionsFieldName?: string | null;
+    acceptFileTypes?: string | null;
+    maxFileSize?: number | null;
+    maxFiles?: number | null;
+    storageBucket?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Возможные типы значений полей в зависимости от DbType
+ */
+type FieldValue = string | number | boolean | Date | string[] | null | undefined;
+/**
+ * Маппинг DbType на TypeScript типы
+ */
+type DbTypeToTSType = {
+    varchar: string;
+    float: number;
+    boolean: boolean;
+    timestamptz: string | Date;
+    manyToOne: string;
+    oneToMany: string[];
+    manyToMany: string[];
+    oneToOne: string;
+    files: string[];
+};
+/**
+ * Generic тип для данных сущности с типобезопасностью
+ */
+type EntityData<T extends Record<string, FieldValue> = Record<string, FieldValue>> = T;
+interface EntityInstance<TData extends Record<string, FieldValue> = Record<string, FieldValue>> {
+    id: string;
+    entityDefinitionId: string;
+    projectId: string;
+    data: EntityData<TData>;
+    createdBy?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+type RelationType = "manyToMany" | "manyToOne" | "oneToMany" | "oneToOne";
+interface EntityRelation {
+    id: string;
+    sourceInstanceId: string;
+    targetInstanceId: string;
+    relationFieldId: string;
+    reverseFieldId?: string | null;
+    relationType: RelationType;
+    createdAt: string;
+}
+/**
+ * Экземпляр сущности с полями и связями (плоская структура)
+ * Все поля размещены на верхнем уровне, без data и relations
+ */
+type EntityInstanceWithFields<TFields extends Record<string, FieldValue> = Record<string, FieldValue>> = {
+    id: string;
+    entityDefinitionId: string;
+    projectId: string;
+    createdAt: string;
+    updatedAt: string;
+} & TFields;
+/**
+ * Тип фильтра для поля
+ */
+type FilterValue = FieldValue | FieldValue[];
+/**
+ * Конфигурация для получения списка экземпляров
+ */
+interface GetInstancesOptions<TFilters extends Record<string, FilterValue> = Record<string, FilterValue>> {
+    includeRelations?: string[];
+    relationsAsIds?: boolean;
+    filters?: TFilters;
+    limit?: number;
+    offset?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+}
+/**
+ * Данные для создания/обновления экземпляра
+ */
+type InstanceData<TData extends Record<string, FieldValue> = Record<string, FieldValue>> = TData;
+/**
+ * Связи для создания/обновления
+ */
+interface RelationsData {
+    [fieldName: string]: string[];
+}
+/**
+ * Type guard для проверки, что значение является валидным FieldValue
+ */
+declare function isFieldValue(value: unknown): value is FieldValue;
+/**
+ * Type guard для проверки EntityData
+ */
+declare function isEntityData(value: unknown): value is Record<string, FieldValue>;
+/**
+ * Безопасное извлечение значения поля с типом
+ */
+declare function getFieldValue<T extends FieldValue>(data: Record<string, FieldValue>, fieldName: string, defaultValue?: T): T | undefined;
+/**
+ * Partial тип для обновления данных сущности
+ */
+type PartialInstanceData<T extends Record<string, FieldValue>> = Partial<T>;
+/**
+ * Файл, привязанный к экземпляру сущности
+ */
+interface EntityFile {
+    id: string;
+    entityInstanceId: string;
+    fieldId?: string | null;
+    fileUrl: string;
+    filePath: string;
+    fileName: string;
+    fileSize: number;
+    fileType: string;
+    storageBucket: string;
+    uploadedBy?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Типы для публичного API SDK
+ */
+
+/**
+ * Конфигурация проекта с entityDefinitions и fields
+ */
+interface ProjectConfig {
+    project: {
+        id: string;
+        name: string;
+        enableSignIn: boolean;
+        enableSignUp: boolean;
+    };
+    entityDefinitions: EntityDefinitionConfig[];
+}
+/**
+ * Конфигурация entityDefinition с полями
+ * Расширенная версия со всеми полями для админки и публичного API
+ */
+interface EntityDefinitionConfig {
+    id: string;
+    name: string;
+    description?: string | null;
+    tableName: string;
+    type: "primary" | "secondary" | "tertiary";
+    projectId: string;
+    readPermission: string;
+    createPermission: string;
+    updatePermission: string;
+    deletePermission: string;
+    titleSection0?: string | null;
+    titleSection1?: string | null;
+    titleSection2?: string | null;
+    titleSection3?: string | null;
+    uiConfig?: PartialUIConfig | null;
+    enablePagination?: boolean | null;
+    pageSize?: number | null;
+    enableFilters?: boolean | null;
+    maxFileSizeMb?: number | null;
+    maxFilesCount?: number | null;
+    createdAt: string;
+    updatedAt: string;
+    fields: FieldConfig[];
+}
+/**
+ * Конфигурация поля
+ * Расширенная версия со всеми полями для админки и публичного API
+ */
+interface FieldConfig {
+    id: string;
+    entityDefinitionId: string;
+    name: string;
+    dbType: DbType;
+    type: FieldType;
+    label: string;
+    placeholder?: string | null;
+    description?: string | null;
+    forEditPage: boolean;
+    forCreatePage: boolean;
+    required: boolean;
+    requiredText?: string | null;
+    forEditPageDisabled: boolean;
+    displayIndex: number;
+    displayInTable: boolean;
+    sectionIndex: number;
+    isOptionTitleField: boolean;
+    searchable: boolean;
+    filterableInList?: boolean;
+    options?: FieldOption[];
+    relatedEntityDefinitionId?: string | null;
+    relationFieldId?: string | null;
+    isRelationSource: boolean;
+    selectorRelationId?: string | null;
+    relationFieldName?: string | null;
+    relationFieldLabel?: string | null;
+    defaultStringValue?: string | null;
+    defaultNumberValue?: number | null;
+    defaultBooleanValue?: boolean | null;
+    defaultDateValue?: string | null;
+    autoPopulate: boolean;
+    includeInSinglePma: boolean;
+    includeInListPma: boolean;
+    includeInSingleSa: boolean;
+    includeInListSa: boolean;
+    foreignKey?: string | null;
+    foreignKeyValue?: string | null;
+    typeFieldName?: string | null;
+    optionsFieldName?: string | null;
+    acceptFileTypes?: string | null;
+    maxFileSize?: number | null;
+    maxFiles?: number | null;
+    storageBucket?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Информация о фильтре для relation-поля
+ */
+interface RelationFilterInfo {
+    fieldName: string;
+    fieldId: string;
+}
+/**
+ * Режим фильтрации для relation полей
+ * - 'any': хотя бы одно из выбранных значений (OR) - по умолчанию
+ * - 'all': все выбранные значения (AND)
+ */
+type RelationFilterMode = "any" | "all";
+/**
+ * Параметры запроса для получения списка экземпляров
+ */
+interface QueryParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    filters?: Record<string, string[]>;
+    relationFilterModes?: Record<string, RelationFilterMode>;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    relationsAsIds?: boolean;
+}
+/**
+ * Данные для создания экземпляра
+ */
+interface CreateInstanceData {
+    data: Record<string, unknown>;
+    relations?: Record<string, string[]>;
+}
+/**
+ * Данные для обновления экземпляра
+ */
+interface UpdateInstanceData {
+    data: Record<string, unknown>;
+    relations?: Record<string, string[]>;
+}
+/**
+ * Результат пагинации
+ */
+interface PaginationResult {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+}
+/**
+ * Результат авторизации
+ */
+interface AuthResult {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    expiresIn: number;
+    user: {
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        role: string;
+    };
+}
+/**
+ * Данные для регистрации
+ */
+interface SignUpData {
+    email: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+}
+/**
+ * Опции для создания SDK клиента
+ */
+interface SDKOptions {
+    enableCache?: boolean;
+    cacheTTL?: number;
+}
+
+/**
+ * Типы для Supabase Database
+ * Автономные типы для SDK - не зависят от внешних модулей
+ */
+type Json = string | number | boolean | null | {
+    [key: string]: Json | undefined;
+} | Json[];
+interface Database {
+    public: {
+        Tables: {
+            profiles: {
+                Row: {
+                    id: string;
+                    email: string | null;
+                    first_name: string | null;
+                    last_name: string | null;
+                    avatar_url: string | null;
+                    role: string | null;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id: string;
+                    email?: string | null;
+                    first_name?: string | null;
+                    last_name?: string | null;
+                    avatar_url?: string | null;
+                    role?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    email?: string | null;
+                    first_name?: string | null;
+                    last_name?: string | null;
+                    avatar_url?: string | null;
+                    role?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            admin_roles: {
+                Row: {
+                    id: string;
+                    name: string;
+                    description: string | null;
+                    created_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    name: string;
+                    description?: string | null;
+                    created_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    name?: string;
+                    description?: string | null;
+                    created_at?: string;
+                };
+            };
+            admins: {
+                Row: {
+                    id: string;
+                    user_id: string;
+                    role_id: string;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    user_id: string;
+                    role_id: string;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    user_id?: string;
+                    role_id?: string;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            projects: {
+                Row: {
+                    id: string;
+                    name: string;
+                    description: string | null;
+                    status: string;
+                    created_by: string | null;
+                    enable_sign_in: boolean;
+                    enable_sign_up: boolean;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    name: string;
+                    description?: string | null;
+                    status?: string;
+                    created_by?: string | null;
+                    enable_sign_in?: boolean;
+                    enable_sign_up?: boolean;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    name?: string;
+                    description?: string | null;
+                    status?: string;
+                    created_by?: string | null;
+                    enable_sign_in?: boolean;
+                    enable_sign_up?: boolean;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            entity_definition: {
+                Row: {
+                    id: string;
+                    name: string;
+                    url: string;
+                    description: string | null;
+                    table_name: string;
+                    type: string;
+                    project_id: string;
+                    create_permission: string;
+                    read_permission: string;
+                    update_permission: string;
+                    delete_permission: string;
+                    title_section_0: string | null;
+                    title_section_1: string | null;
+                    title_section_2: string | null;
+                    title_section_3: string | null;
+                    ui_config: Json | null;
+                    enable_pagination: boolean;
+                    page_size: number;
+                    enable_filters: boolean;
+                    max_file_size_mb: number | null;
+                    max_files_count: number | null;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    name: string;
+                    url: string;
+                    description?: string | null;
+                    table_name: string;
+                    type: string;
+                    project_id: string;
+                    create_permission?: string;
+                    read_permission?: string;
+                    update_permission?: string;
+                    delete_permission?: string;
+                    title_section_0?: string | null;
+                    title_section_1?: string | null;
+                    title_section_2?: string | null;
+                    title_section_3?: string | null;
+                    ui_config?: Json | null;
+                    enable_pagination?: boolean;
+                    page_size?: number;
+                    enable_filters?: boolean;
+                    max_file_size_mb?: number | null;
+                    max_files_count?: number | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    name?: string;
+                    url?: string;
+                    description?: string | null;
+                    table_name?: string;
+                    type?: string;
+                    project_id?: string;
+                    create_permission?: string;
+                    read_permission?: string;
+                    update_permission?: string;
+                    delete_permission?: string;
+                    title_section_0?: string | null;
+                    title_section_1?: string | null;
+                    title_section_2?: string | null;
+                    title_section_3?: string | null;
+                    ui_config?: Json | null;
+                    enable_pagination?: boolean;
+                    page_size?: number;
+                    enable_filters?: boolean;
+                    max_file_size_mb?: number | null;
+                    max_files_count?: number | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            field: {
+                Row: {
+                    id: string;
+                    entity_definition_id: string;
+                    name: string;
+                    db_type: string;
+                    type: string;
+                    label: string;
+                    placeholder: string | null;
+                    description: string | null;
+                    for_edit_page: boolean;
+                    for_create_page: boolean;
+                    required: boolean;
+                    required_text: string | null;
+                    for_edit_page_disabled: boolean;
+                    display_index: number;
+                    display_in_table: boolean;
+                    section_index: number | null;
+                    is_option_title_field: boolean;
+                    searchable: boolean;
+                    filterable_in_list: boolean;
+                    options: Json | null;
+                    related_entity_definition_id: string | null;
+                    relation_field_id: string | null;
+                    is_relation_source: boolean;
+                    selector_relation_id: string | null;
+                    default_string_value: string | null;
+                    default_number_value: number | null;
+                    default_boolean_value: boolean | null;
+                    default_date_value: string | null;
+                    auto_populate: boolean;
+                    include_in_single_pma: boolean;
+                    include_in_list_pma: boolean;
+                    include_in_single_sa: boolean;
+                    include_in_list_sa: boolean;
+                    relation_field_name: string | null;
+                    relation_field_label: string | null;
+                    foreign_key: string | null;
+                    foreign_key_value: string | null;
+                    type_field_name: string | null;
+                    options_field_name: string | null;
+                    accept_file_types: string | null;
+                    max_file_size: number | null;
+                    max_files: number | null;
+                    storage_bucket: string | null;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    entity_definition_id: string;
+                    name: string;
+                    db_type: string;
+                    type: string;
+                    label: string;
+                    placeholder?: string | null;
+                    description?: string | null;
+                    for_edit_page?: boolean;
+                    for_create_page?: boolean;
+                    required?: boolean;
+                    required_text?: string | null;
+                    for_edit_page_disabled?: boolean;
+                    display_index?: number;
+                    display_in_table?: boolean;
+                    section_index?: number | null;
+                    is_option_title_field?: boolean;
+                    searchable?: boolean;
+                    filterable_in_list?: boolean;
+                    options?: Json | null;
+                    related_entity_definition_id?: string | null;
+                    relation_field_id?: string | null;
+                    is_relation_source?: boolean;
+                    selector_relation_id?: string | null;
+                    default_string_value?: string | null;
+                    default_number_value?: number | null;
+                    default_boolean_value?: boolean | null;
+                    default_date_value?: string | null;
+                    auto_populate?: boolean;
+                    include_in_single_pma?: boolean;
+                    include_in_list_pma?: boolean;
+                    include_in_single_sa?: boolean;
+                    include_in_list_sa?: boolean;
+                    relation_field_name?: string | null;
+                    relation_field_label?: string | null;
+                    foreign_key?: string | null;
+                    foreign_key_value?: string | null;
+                    type_field_name?: string | null;
+                    options_field_name?: string | null;
+                    accept_file_types?: string | null;
+                    max_file_size?: number | null;
+                    max_files?: number | null;
+                    storage_bucket?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    entity_definition_id?: string;
+                    name?: string;
+                    db_type?: string;
+                    type?: string;
+                    label?: string;
+                    placeholder?: string | null;
+                    description?: string | null;
+                    for_edit_page?: boolean;
+                    for_create_page?: boolean;
+                    required?: boolean;
+                    required_text?: string | null;
+                    for_edit_page_disabled?: boolean;
+                    display_index?: number;
+                    display_in_table?: boolean;
+                    section_index?: number | null;
+                    is_option_title_field?: boolean;
+                    searchable?: boolean;
+                    filterable_in_list?: boolean;
+                    options?: Json | null;
+                    related_entity_definition_id?: string | null;
+                    relation_field_id?: string | null;
+                    is_relation_source?: boolean;
+                    selector_relation_id?: string | null;
+                    default_string_value?: string | null;
+                    default_number_value?: number | null;
+                    default_boolean_value?: boolean | null;
+                    default_date_value?: string | null;
+                    auto_populate?: boolean;
+                    include_in_single_pma?: boolean;
+                    include_in_list_pma?: boolean;
+                    include_in_single_sa?: boolean;
+                    include_in_list_sa?: boolean;
+                    relation_field_name?: string | null;
+                    relation_field_label?: string | null;
+                    foreign_key?: string | null;
+                    foreign_key_value?: string | null;
+                    type_field_name?: string | null;
+                    options_field_name?: string | null;
+                    accept_file_types?: string | null;
+                    max_file_size?: number | null;
+                    max_files?: number | null;
+                    storage_bucket?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            entity_instance: {
+                Row: {
+                    id: string;
+                    entity_definition_id: string;
+                    project_id: string;
+                    data: Json;
+                    created_by: string | null;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    entity_definition_id: string;
+                    project_id: string;
+                    data?: Json;
+                    created_by?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    entity_definition_id?: string;
+                    project_id?: string;
+                    data?: Json;
+                    created_by?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            entity_file: {
+                Row: {
+                    id: string;
+                    entity_instance_id: string;
+                    field_id: string | null;
+                    file_url: string;
+                    file_path: string;
+                    file_name: string;
+                    file_size: number;
+                    file_type: string;
+                    storage_bucket: string;
+                    uploaded_by: string | null;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    entity_instance_id: string;
+                    field_id?: string | null;
+                    file_url: string;
+                    file_path: string;
+                    file_name: string;
+                    file_size: number;
+                    file_type: string;
+                    storage_bucket?: string;
+                    uploaded_by?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    entity_instance_id?: string;
+                    field_id?: string | null;
+                    file_url?: string;
+                    file_path?: string;
+                    file_name?: string;
+                    file_size?: number;
+                    file_type?: string;
+                    storage_bucket?: string;
+                    uploaded_by?: string | null;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+            entity_relation: {
+                Row: {
+                    id: string;
+                    source_instance_id: string;
+                    target_instance_id: string;
+                    relation_field_id: string;
+                    reverse_field_id: string | null;
+                    relation_type: string;
+                    created_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    source_instance_id: string;
+                    target_instance_id: string;
+                    relation_field_id: string;
+                    reverse_field_id?: string | null;
+                    relation_type: string;
+                    created_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    source_instance_id?: string;
+                    target_instance_id?: string;
+                    relation_field_id?: string;
+                    reverse_field_id?: string | null;
+                    relation_type?: string;
+                    created_at?: string;
+                };
+            };
+            environments: {
+                Row: {
+                    id: string;
+                    project_id: string;
+                    key: string;
+                    type: "string" | "number" | "boolean" | "select";
+                    value: Json | null;
+                    options: Json;
+                    created_at: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    id?: string;
+                    project_id: string;
+                    key: string;
+                    type: "string" | "number" | "boolean" | "select";
+                    value?: Json | null;
+                    options?: Json;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    id?: string;
+                    project_id?: string;
+                    key?: string;
+                    type?: "string" | "number" | "boolean" | "select";
+                    value?: Json | null;
+                    options?: Json;
+                    created_at?: string;
+                    updated_at?: string;
+                };
+            };
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            get_user_role: {
+                Args: {
+                    user_uuid: string;
+                };
+                Returns: string;
+            };
+            is_super_admin: {
+                Args: {
+                    user_uuid: string;
+                };
+                Returns: boolean;
+            };
+            is_admin: {
+                Args: {
+                    user_uuid: string;
+                };
+                Returns: boolean;
+            };
+            search_entity_instances: {
+                Args: {
+                    p_entity_definition_id: string;
+                    p_project_id: string;
+                    p_search_term: string;
+                    p_search_fields?: string[];
+                    p_limit?: number;
+                    p_offset?: number;
+                };
+                Returns: Array<{
+                    id: string;
+                    entity_definition_id: string;
+                    project_id: string;
+                    data: Json;
+                    created_at: string;
+                    updated_at: string;
+                    total_count: number;
+                }>;
+            };
+            get_related_instances: {
+                Args: {
+                    p_source_instance_ids: string[];
+                    p_relation_field_ids: string[];
+                };
+                Returns: Array<{
+                    source_instance_id: string;
+                    relation_field_id: string;
+                    target_instance_id: string;
+                    target_entity_definition_id: string;
+                    target_project_id: string;
+                    target_data: Json;
+                    target_created_at: string;
+                    target_updated_at: string;
+                }>;
+            };
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+    };
+}
+
+/**
+ * Базовый класс для публичного API SDK
+ * Содержит общую логику: кэширование, загрузка конфигурации
+ */
+
+/**
+ * Базовый класс для публичного API клиента
+ */
+declare abstract class BasePublicAPIClient {
+    protected supabase: SupabaseClient<Database>;
+    protected projectId: string;
+    private enableCache;
+    private cacheTTL;
+    private configCache;
+    constructor(supabase: SupabaseClient<Database>, projectId: string, options?: SDKOptions);
+    /**
+     * Загрузить fields для entityDefinition (с кэшированием)
+     *
+     * Флоу работы с кэшем:
+     *
+     * 1. Если enableCache === true (публичный API):
+     *    - Проверяет кэш по entityDefinitionId
+     *    - Если есть в кэше и не истек → возвращает из кэша (0 запросов к БД)
+     *    - Если нет в кэше или истек → загружает из БД и кэширует (1 запрос к БД)
+     *
+     * 2. Если enableCache === false (админка):
+     *    - Пропускает проверку кэша (эквивалент forceRefresh: true)
+     *    - Всегда загружает из БД (1 запрос к БД)
+     *    - Не сохраняет в кэш (всегда свежие данные)
+     *
+     * Используется внутри SDK для получения fields перед операциями с instances.
+     * Fields нужны для определения типов полей, relations, и уплощения данных.
+     */
+    protected getFields(entityDefinitionId: string): Promise<FieldConfig[]>;
+    /**
+     * Преобразование данных entity_definition из БД в EntityDefinitionConfig
+     */
+    private transformEntityDefinitionFromDB;
+    /**
+     * Преобразование данных field из БД в FieldConfig
+     */
+    private transformFieldFromDB;
+    /**
+     * Загрузить entityDefinition с полями одним запросом (JOIN)
+     * Кэширует всю конфигурацию целиком (entityDefinition + fields)
+     *
+     * Логика кэширования:
+     * - enableCache: true → использует кэш, сохраняет в кэш (TTL: 5 минут по умолчанию)
+     * - enableCache: false → всегда загружает из БД, не использует кэш (эквивалент forceRefresh: true)
+     *
+     * @returns EntityDefinitionConfig с полями, отсортированными по display_index
+     */
+    getEntityDefinitionConfig(entityDefinitionId: string): Promise<EntityDefinitionConfig>;
+    /**
+     * Преобразование EntityDefinitionConfig в EntityDefinition
+     */
+    private convertToEntityDefinition;
+    /**
+     * Преобразование FieldConfig в Field
+     */
+    private convertToField;
+    /**
+     * Получить entity definition с полями и сгенерированным UI конфигом
+     * Использует кэш SDK для оптимизации (если дефиниция уже загружена, не делает повторный запрос)
+     *
+     * @param entityDefinitionId - ID entity definition
+     * @returns EntityDefinition, Fields и UI конфиг, или null если не найдено
+     */
+    getEntityDefinitionWithUIConfig(entityDefinitionId: string): Promise<{
+        entityDefinition: EntityDefinition;
+        fields: Field[];
+        uiConfig: EntityUIConfig;
+    } | null>;
+    /**
+     * Очистить кэш
+     */
+    clearCache(): void;
+    abstract getInstances(entityDefinitionId: string, params?: QueryParams): Promise<{
+        data: EntityInstanceWithFields[];
+        pagination: PaginationResult;
+    }>;
+    abstract getInstance(entityDefinitionId: string, id: string, params?: {
+        relationsAsIds?: boolean;
+    }): Promise<EntityInstanceWithFields>;
+    abstract createInstance(entityDefinitionId: string, data: CreateInstanceData): Promise<EntityInstanceWithFields>;
+    abstract updateInstance(entityDefinitionId: string, id: string, data: UpdateInstanceData): Promise<EntityInstanceWithFields>;
+    abstract deleteInstance(entityDefinitionId: string, id: string): Promise<void>;
+    abstract signIn(email: string, password: string): Promise<AuthResult>;
+    abstract signUp(data: SignUpData): Promise<AuthResult>;
+    abstract signOut(): Promise<void>;
+    abstract getCurrentUser(): Promise<AuthResult["user"] | null>;
+}
+
+/**
+ * Унифицированный SDK клиент для работы с экземплярами сущностей
+ * Поддерживает как Server Components (SSR), так и Client Components
+ * Использует динамические импорты для изоляции server/client кода
+ */
+
+/**
+ * Унифицированный публичный API клиент
+ * Работает как в server, так и в client режиме
+ */
+declare class PublicAPIClient extends BasePublicAPIClient {
+    private static instances;
+    private mode;
+    private constructor();
+    /**
+     * Создать SDK клиент напрямую с Supabase инстансом
+     * Используется для создания через фабричные функции createServerSDK/createClientSDK
+     *
+     * @param supabase - Supabase клиент
+     * @param projectId - ID проекта
+     * @param mode - Режим работы: 'server' для SSR, 'client' для браузера
+     * @param options - Опции SDK (кэширование и т.д.)
+     */
+    static create(supabase: SupabaseClient<Database>, projectId: string, mode: "server" | "client", options?: SDKOptions): PublicAPIClient;
+    /**
+     * Получить режим работы клиента (для отладки)
+     */
+    getMode(): "server" | "client";
+    /**
+     * Получить один экземпляр
+     */
+    getInstance(entityDefinitionId: string, id: string, params?: {
+        relationsAsIds?: boolean;
+    }): Promise<EntityInstanceWithFields>;
+    /**
+     * Получить список экземпляров
+     * Поддерживает поиск, фильтры (JSONB и relation), пагинацию
+     */
+    getInstances(entityDefinitionId: string, params?: QueryParams): Promise<{
+        data: EntityInstanceWithFields[];
+        pagination: PaginationResult;
+    }>;
+    /**
+     * Создать экземпляр сущности
+     * Поддерживает создание с relations и автоматически устанавливает created_by
+     */
+    createInstance(entityDefinitionId: string, data: CreateInstanceData): Promise<EntityInstanceWithFields>;
+    updateInstance(entityDefinitionId: string, id: string, data: UpdateInstanceData): Promise<EntityInstanceWithFields>;
+    /**
+     * Формирует обновленный экземпляр из уже обновленных данных без повторной загрузки
+     * Оптимизация: избегает лишних запросов после updateInstance
+     * Загружает полные объекты relations для совместимости с форматом списка
+     */
+    private buildUpdatedInstance;
+    /**
+     * Удалить экземпляр сущности
+     * Связи удалятся автоматически через ON DELETE CASCADE
+     */
+    deleteInstance(entityDefinitionId: string, id: string): Promise<void>;
+    signIn(email: string, password: string): Promise<AuthResult>;
+    signUp(data: SignUpData): Promise<AuthResult>;
+    signOut(): Promise<void>;
+    getCurrentUser(): Promise<AuthResult["user"] | null>;
+}
+
+export { type AuthResult as A, type PartialUIConfig as B, type ColumnConfig as C, type DbType as D, type EntityDefinition as E, type FieldConfig as F, type GetInstancesOptions as G, type InstanceData as I, type ListPageConfig as L, type MessagesConfig as M, PublicAPIClient as P, type QueryParams as Q, type RelationFilterInfo as R, type SDKOptions as S, type UpdateInstanceData as U, type FieldValue as a, type Field as b, type EntityUIConfig as c, type ProjectConfig as d, type EntityDefinitionConfig as e, type RelationFilterMode as f, type CreateInstanceData as g, type PaginationResult as h, type SignUpData as i, type FieldType as j, type FieldOption as k, type DbTypeToTSType as l, type EntityData as m, type EntityInstance as n, type RelationType as o, type EntityRelation as p, type EntityInstanceWithFields as q, type FilterValue as r, type RelationsData as s, isFieldValue as t, isEntityData as u, getFieldValue as v, type PartialInstanceData as w, type EntityFile as x, type ActionConfig as y, type FormPageConfig as z };