@igorchugurov/public-api-sdk 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,108 @@
+import { F as FieldConfig, a as FieldValue, E as EntityDefinition, b as Field, c as EntityUIConfig, C as ColumnConfig, S as SDKOptions, P as PublicAPIClient } from './client-DqqjGYgA.mjs';
+export { y as ActionConfig, A as AuthResult, g as CreateInstanceData, D as DbType, l as DbTypeToTSType, m as EntityData, e as EntityDefinitionConfig, x as EntityFile, n as EntityInstance, q as EntityInstanceWithFields, p as EntityRelation, k as FieldOption, j as FieldType, r as FilterValue, z as FormPageConfig, G as GetInstancesOptions, I as InstanceData, L as ListPageConfig, M as MessagesConfig, h as PaginationResult, w as PartialInstanceData, B as PartialUIConfig, d as ProjectConfig, Q as QueryParams, R as RelationFilterInfo, f as RelationFilterMode, o as RelationType, s as RelationsData, i as SignUpData, U as UpdateInstanceData, v as getFieldValue, u as isEntityData, t as isFieldValue } from './client-DqqjGYgA.mjs';
+import '@supabase/supabase-js';
+
+/**
+ * Классы ошибок для публичного API SDK
+ */
+declare class SDKError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    details?: unknown | undefined;
+    constructor(code: string, message: string, statusCode?: number | undefined, details?: unknown | undefined);
+}
+declare class NotFoundError extends SDKError {
+    constructor(resource: string, id?: string);
+}
+declare class PermissionDeniedError extends SDKError {
+    constructor(action: string, resource: string);
+}
+declare class ValidationError extends SDKError {
+    constructor(field: string, message: string);
+}
+declare class AuthenticationError extends SDKError {
+    constructor(message?: string);
+}
+/**
+ * Обработка ошибок Supabase и преобразование в SDK ошибки
+ */
+declare function handleSupabaseError(error: any): never;
+/**
+ * Обработка ошибок при работе с entity instance
+ * Специфичная обработка для операций с instances
+ */
+declare function handleInstanceError(error: any, instanceId: string): never;
+
+/**
+ * Утилиты для публичного API SDK
+ */
+
+/**
+ * Результат валидации данных
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Валидация данных на основе fields конфигурации
+ */
+declare function validateInstanceData(data: Record<string, unknown>, fields: FieldConfig[]): ValidationResult;
+/**
+ * Нормализация значения поля
+ */
+declare function normalizeFieldValue(value: unknown, field: FieldConfig): FieldValue;
+/**
+ * Трансформация snake_case → camelCase
+ */
+declare function toCamelCase(str: string): string;
+/**
+ * Трансформация camelCase → snake_case
+ */
+declare function toSnakeCase(str: string): string;
+
+/**
+ * Генерация UI конфигурации из EntityDefinition и Fields
+ * Единый источник истины для генерации UI конфигурации в SDK
+ *
+ * Основная логика:
+ * 1. Генерируем defaults на основе имени сущности
+ * 2. Мержим с custom конфигом из entityDefinition.uiConfig
+ * 3. Генерируем колонки таблицы из полей с displayInTable: true
+ */
+
+/**
+ * Генерирует полную UI конфигурацию с defaults
+ * @param entityDefinition - Определение сущности из БД
+ * @param fields - Поля сущности из БД
+ * @returns Полная UI конфигурация со всеми значениями
+ */
+declare function generateUIConfig(entityDefinition: EntityDefinition, fields: Field[]): EntityUIConfig;
+/**
+ * Утилита для форматирования колонок из старого формата
+ * Для обратной совместимости с config/*.json
+ */
+declare function getColumnsFromFields(fields: Field[]): ColumnConfig[];
+
+/**
+ * Фабрика для создания SDK клиента в Client Components
+ * Автономная версия - принимает ключи Supabase как параметры
+ */
+
+/**
+ * Создать SDK клиент для Client Components
+ * @param projectId - ID проекта
+ * @param config - Конфигурация Supabase
+ * @param config.supabaseUrl - URL Supabase проекта
+ * @param config.supabaseAnonKey - Anon ключ Supabase
+ * @param options - Опции SDK (кэширование и т.д.)
+ */
+declare function createClientSDK(projectId: string, config: {
+    supabaseUrl: string;
+    supabaseAnonKey: string;
+}, options?: SDKOptions): PublicAPIClient;
+
+export { AuthenticationError, ColumnConfig, EntityDefinition, EntityUIConfig, Field, FieldConfig, FieldValue, NotFoundError, PermissionDeniedError, PublicAPIClient, SDKError, SDKOptions, ValidationError, type ValidationResult, createClientSDK, generateUIConfig, getColumnsFromFields, handleInstanceError, handleSupabaseError, normalizeFieldValue, toCamelCase, toSnakeCase, validateInstanceData };

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+import { F as FieldConfig, a as FieldValue, E as EntityDefinition, b as Field, c as EntityUIConfig, C as ColumnConfig, S as SDKOptions, P as PublicAPIClient } from './client-DqqjGYgA.js';
+export { y as ActionConfig, A as AuthResult, g as CreateInstanceData, D as DbType, l as DbTypeToTSType, m as EntityData, e as EntityDefinitionConfig, x as EntityFile, n as EntityInstance, q as EntityInstanceWithFields, p as EntityRelation, k as FieldOption, j as FieldType, r as FilterValue, z as FormPageConfig, G as GetInstancesOptions, I as InstanceData, L as ListPageConfig, M as MessagesConfig, h as PaginationResult, w as PartialInstanceData, B as PartialUIConfig, d as ProjectConfig, Q as QueryParams, R as RelationFilterInfo, f as RelationFilterMode, o as RelationType, s as RelationsData, i as SignUpData, U as UpdateInstanceData, v as getFieldValue, u as isEntityData, t as isFieldValue } from './client-DqqjGYgA.js';
+import '@supabase/supabase-js';
+
+/**
+ * Классы ошибок для публичного API SDK
+ */
+declare class SDKError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    details?: unknown | undefined;
+    constructor(code: string, message: string, statusCode?: number | undefined, details?: unknown | undefined);
+}
+declare class NotFoundError extends SDKError {
+    constructor(resource: string, id?: string);
+}
+declare class PermissionDeniedError extends SDKError {
+    constructor(action: string, resource: string);
+}
+declare class ValidationError extends SDKError {
+    constructor(field: string, message: string);
+}
+declare class AuthenticationError extends SDKError {
+    constructor(message?: string);
+}
+/**
+ * Обработка ошибок Supabase и преобразование в SDK ошибки
+ */
+declare function handleSupabaseError(error: any): never;
+/**
+ * Обработка ошибок при работе с entity instance
+ * Специфичная обработка для операций с instances
+ */
+declare function handleInstanceError(error: any, instanceId: string): never;
+
+/**
+ * Утилиты для публичного API SDK
+ */
+
+/**
+ * Результат валидации данных
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Валидация данных на основе fields конфигурации
+ */
+declare function validateInstanceData(data: Record<string, unknown>, fields: FieldConfig[]): ValidationResult;
+/**
+ * Нормализация значения поля
+ */
+declare function normalizeFieldValue(value: unknown, field: FieldConfig): FieldValue;
+/**
+ * Трансформация snake_case → camelCase
+ */
+declare function toCamelCase(str: string): string;
+/**
+ * Трансформация camelCase → snake_case
+ */
+declare function toSnakeCase(str: string): string;
+
+/**
+ * Генерация UI конфигурации из EntityDefinition и Fields
+ * Единый источник истины для генерации UI конфигурации в SDK
+ *
+ * Основная логика:
+ * 1. Генерируем defaults на основе имени сущности
+ * 2. Мержим с custom конфигом из entityDefinition.uiConfig
+ * 3. Генерируем колонки таблицы из полей с displayInTable: true
+ */
+
+/**
+ * Генерирует полную UI конфигурацию с defaults
+ * @param entityDefinition - Определение сущности из БД
+ * @param fields - Поля сущности из БД
+ * @returns Полная UI конфигурация со всеми значениями
+ */
+declare function generateUIConfig(entityDefinition: EntityDefinition, fields: Field[]): EntityUIConfig;
+/**
+ * Утилита для форматирования колонок из старого формата
+ * Для обратной совместимости с config/*.json
+ */
+declare function getColumnsFromFields(fields: Field[]): ColumnConfig[];
+
+/**
+ * Фабрика для создания SDK клиента в Client Components
+ * Автономная версия - принимает ключи Supabase как параметры
+ */
+
+/**
+ * Создать SDK клиент для Client Components
+ * @param projectId - ID проекта
+ * @param config - Конфигурация Supabase
+ * @param config.supabaseUrl - URL Supabase проекта
+ * @param config.supabaseAnonKey - Anon ключ Supabase
+ * @param options - Опции SDK (кэширование и т.д.)
+ */
+declare function createClientSDK(projectId: string, config: {
+    supabaseUrl: string;
+    supabaseAnonKey: string;
+}, options?: SDKOptions): PublicAPIClient;
+
+export { AuthenticationError, ColumnConfig, EntityDefinition, EntityUIConfig, Field, FieldConfig, FieldValue, NotFoundError, PermissionDeniedError, PublicAPIClient, SDKError, SDKOptions, ValidationError, type ValidationResult, createClientSDK, generateUIConfig, getColumnsFromFields, handleInstanceError, handleSupabaseError, normalizeFieldValue, toCamelCase, toSnakeCase, validateInstanceData };