@svadmin/core 0.0.6 → 0.4.1

package/src/http-error.test.ts

@@ -0,0 +1,85 @@
+// HttpError + CrudOperator + LogicalFilter tests
+import { describe, test, expect } from 'bun:test';
+import { HttpError } from './types';
+import type { CrudOperator, Filter, LogicalFilter } from './types';
+
+describe('HttpError', () => {
+  test('creates with message and statusCode', () => {
+    const err = new HttpError('Not Found', 404);
+    expect(err.message).toBe('Not Found');
+    expect(err.statusCode).toBe(404);
+    expect(err.name).toBe('HttpError');
+    expect(err.errors).toBeUndefined();
+  });
+
+  test('creates with validation errors', () => {
+    const err = new HttpError('Validation Failed', 422, {
+      email: ['Email is required', 'Email must be valid'],
+      name: 'Name is required',
+    });
+    expect(err.statusCode).toBe(422);
+    expect(err.errors!.email).toEqual(['Email is required', 'Email must be valid']);
+    expect(err.errors!.name).toBe('Name is required');
+  });
+
+  test('is instanceof Error', () => {
+    const err = new HttpError('Server Error', 500);
+    expect(err instanceof Error).toBe(true);
+    expect(err instanceof HttpError).toBe(true);
+  });
+});
+
+describe('CrudOperator types', () => {
+  test('all operators are valid', () => {
+    const operators: CrudOperator[] = [
+      'eq', 'ne', 'lt', 'gt', 'lte', 'gte',
+      'contains', 'ncontains',
+      'startswith', 'endswith',
+      'in', 'nin',
+      'null', 'nnull',
+      'between', 'nbetween',
+    ];
+    expect(operators).toHaveLength(16);
+  });
+
+  test('Filter uses CrudOperator', () => {
+    const filter: Filter = { field: 'name', operator: 'startswith', value: 'A' };
+    expect(filter.operator).toBe('startswith');
+  });
+
+  test('negation operators', () => {
+    const filters: Filter[] = [
+      { field: 'status', operator: 'ncontains', value: 'draft' },
+      { field: 'deleted_at', operator: 'nnull', value: null },
+      { field: 'category', operator: 'nin', value: [1, 2] },
+      { field: 'price', operator: 'nbetween', value: [100, 200] },
+    ];
+    expect(filters).toHaveLength(4);
+  });
+});
+
+describe('LogicalFilter', () => {
+  test('or combination', () => {
+    const logical: LogicalFilter = {
+      operator: 'or',
+      value: [
+        { field: 'status', operator: 'eq', value: 'published' },
+        { field: 'status', operator: 'eq', value: 'draft' },
+      ],
+    };
+    expect(logical.operator).toBe('or');
+    expect(logical.value).toHaveLength(2);
+  });
+
+  test('and combination', () => {
+    const logical: LogicalFilter = {
+      operator: 'and',
+      value: [
+        { field: 'price', operator: 'gte', value: 10 },
+        { field: 'price', operator: 'lte', value: 100 },
+      ],
+    };
+    expect(logical.operator).toBe('and');
+    expect(logical.value).toHaveLength(2);
+  });
+});

package/src/i18n.svelte.ts

@@ -38,6 +38,9 @@ const locales: Record<string, Locale> = {
     'common.home': '首页',
     'common.logout': '退出登录',
     'common.toggleTheme': '切换主题',
+    'common.switchLanguage': '切换语言',
+    'common.clear': '清除',
+    'common.menu': '菜单',
     'common.darkMode': '暗色模式',
     'common.lightMode': '亮色模式',
     'common.detail': '详情',
@@ -47,16 +50,39 @@ const locales: Record<string, Locale> = {
     'common.retry': '重试',
     'common.yes': '是',
     'common.no': '否',
+    'common.undo': '撤销',
+    'common.filter': '筛选',
+    'common.reset': '重置',
+    'common.welcome': '欢迎使用 {title}',
+    'common.dashboardHint': '从侧边栏选择一个资源开始。',
+    'common.redirecting': '正在跳转到登录页...',
+    'common.expand': '展开',
+    'common.collapse': '收起',
+    'common.close': '关闭',
+    'common.copy': '复制',
+    'common.copyAll': '复制全部',
+    'common.copied': '已复制',
+    'common.next': '下一步',
+    'common.back': '返回',
+    'common.step': '步骤',
+    'common.columns': '列',
+    'common.perPage': '每页',
+    'common.copyId': '复制 ID',
+    'common.showMore': '展开更多',
+    'common.showLess': '收起',
     // Field
     'field.enterValue': '输入{label}',
     'field.selectPlaceholder': '请选择',
     'field.tagsPlaceholder': '输入标签后按回车...',
+    'field.noOptions': '无可用选项',
+    'field.addImage': '添加图片',
     // Config errors
     'config.missingEnvTitle': '环境配置缺失',
     'config.missingEnvDescription': '应用无法启动，因为缺少必要的环境变量。',
     'config.addToEnvFile': '请在 .env 文件中添加以下内容：',
     'config.envFilePath': '文件路径: .env',
     'config.reload': '配置完成后刷新页面',
+    'config.reloadButton': '重新加载页面',
     // Auth pages
     'auth.login': '登录',
     'auth.register': '注册',
@@ -83,6 +109,17 @@ const locales: Record<string, Locale> = {
     'auth.welcomeMessage': '登录以继续使用管理后台',
     'auth.createAccount': '创建账号',
     'auth.createAccountMessage': '填写信息以创建您的账号',
+    // AutoSave
+    'autoSave.idle': '已保存',
+    'autoSave.saving': '保存中...',
+    'autoSave.saved': '已保存',
+    'autoSave.error': '保存失败',
+    // Empty states
+    'empty.title': '暂无数据',
+    'empty.description': '没有找到符合条件的记录。',
+    'empty.noMore': '没有更多了',
+    // DevTools
+    'devtools.title': '开发者工具 (Ctrl+Shift+D)',
     // Validation
     'validation.required': '此字段为必填项',
     'validation.minLength': '最少 {min} 个字符',
@@ -125,6 +162,9 @@ const locales: Record<string, Locale> = {
     'common.home': 'Home',
     'common.logout': 'Log out',
     'common.toggleTheme': 'Toggle theme',
+    'common.switchLanguage': 'Switch language',
+    'common.clear': 'Clear',
+    'common.menu': 'Menu',
     'common.darkMode': 'Dark mode',
     'common.lightMode': 'Light mode',
     'common.detail': 'Detail',
@@ -134,16 +174,39 @@ const locales: Record<string, Locale> = {
     'common.retry': 'Retry',
     'common.yes': 'Yes',
     'common.no': 'No',
+    'common.undo': 'Undo',
+    'common.filter': 'Filter',
+    'common.reset': 'Reset',
+    'common.welcome': 'Welcome to {title}',
+    'common.dashboardHint': 'Select a resource from the sidebar to get started.',
+    'common.redirecting': 'Redirecting to login...',
+    'common.expand': 'Expand',
+    'common.collapse': 'Collapse',
+    'common.close': 'Close',
+    'common.copy': 'Copy',
+    'common.copyAll': 'Copy All',
+    'common.copied': 'Copied!',
+    'common.next': 'Next',
+    'common.back': 'Back',
+    'common.step': 'Step',
+    'common.columns': 'Columns',
+    'common.perPage': 'per page',
+    'common.copyId': 'Copy ID',
+    'common.showMore': 'Show more',
+    'common.showLess': 'Show less',
     // Field
     'field.enterValue': 'Enter {label}',
     'field.selectPlaceholder': 'Select...',
     'field.tagsPlaceholder': 'Type a tag and press Enter...',
+    'field.noOptions': 'No options available',
+    'field.addImage': 'Add image',
     // Config errors
     'config.missingEnvTitle': 'Missing Configuration',
     'config.missingEnvDescription': 'The app cannot start because required environment variables are missing.',
     'config.addToEnvFile': 'Add the following to your .env file:',
     'config.envFilePath': 'File path: .env',
-    'config.reload': 'Reload after configuration',
+    'config.reload': 'Refresh page after configuration',
+    'config.reloadButton': 'Reload Page',
     // Auth pages
     'auth.login': 'Login',
     'auth.register': 'Register',
@@ -170,6 +233,17 @@ const locales: Record<string, Locale> = {
     'auth.welcomeMessage': 'Sign in to continue to admin panel',
     'auth.createAccount': 'Create Account',
     'auth.createAccountMessage': 'Fill in your details to create an account',
+    // AutoSave
+    'autoSave.idle': 'Saved',
+    'autoSave.saving': 'Saving...',
+    'autoSave.saved': 'Saved',
+    'autoSave.error': 'Save failed',
+    // Empty states
+    'empty.title': 'No data',
+    'empty.description': 'No records found matching your criteria.',
+    'empty.noMore': 'No more items',
+    // DevTools
+    'devtools.title': 'DevTools (Ctrl+Shift+D)',
     // Validation
     'validation.required': 'This field is required',
     'validation.minLength': 'Minimum {min} characters',
@@ -221,3 +295,15 @@ export function t(key: string, params?: Record<string, string | number>): string
 export function addTranslations(locale: string, translations: Record<string, string>): void {
   locales[locale] = { ...locales[locale], ...translations };
 }
+
+/**
+ * useTranslation — standard i18n hook
+ * Returns { translate, getLocale, changeLocale }
+ */
+export function useTranslation() {
+  return {
+    translate: t,
+    getLocale,
+    changeLocale: setLocale,
+  };
+}

package/src/index.ts

@@ -1,36 +1,52 @@
 // Core barrel exports
 
 export {
-  setDataProvider, getDataProvider,
+  setDataProvider, getDataProvider, getDataProviderForResource, getDataProviderNames,
   setAuthProvider, getAuthProvider,
   setResources, getResources, getResource,
   setRouterProvider, getRouterProvider,
-} from './context';
+} from './context.svelte';
+export type { DataProviderInput } from './context.svelte';
 export {
   useList, useInfiniteList,
   useOne, useShow,
   useSelect, useMany,
   useCustom, useApiUrl,
+  useCustomMutation, useInvalidate,
   useCreate, useCreateMany,
   useUpdate, useUpdateMany,
   useDelete, useDeleteMany,
   useForm, useTable,
-  useNavigation,
+  useNavigation, useGo, useBack,
+  useGetToPath, useLink,
   useResource,
+  useLog, useLogList,
+  useModalForm, useDrawerForm, useModal,
+  useOvertime, useRelation,
+  useNotification, useDataProvider,
+  useMenu, useBreadcrumb, useThemedLayoutContext,
 } from './hooks.svelte';
-export { matchRoute, navigate, currentPath } from './router';
+export { matchRoute, navigate, currentPath, setActiveRouterProvider } from './router';
 export { readURLState, writeURLState } from './url-sync';
 export { setAccessControl, canAccess, canAccessAsync } from './permissions';
-export { useLive } from './live';
+export { useLive, useSubscription, usePublish } from './live';
 export { toast } from './toast.svelte';
 export { notify, closeNotification, setNotificationProvider, getNotificationProvider } from './notification.svelte';
-export { t, setLocale, getLocale, getAvailableLocales, addTranslations } from './i18n.svelte';
-export { audit, setAuditHandler } from './audit';
+export { t, setLocale, getLocale, getAvailableLocales, addTranslations, useTranslation } from './i18n.svelte';
+export { audit, setAuditHandler, setAuditLogProvider, getAuditLogProvider } from './audit';
+export type { AuditLogProvider } from './audit';
 export { getTheme, setTheme, toggleTheme, getResolvedTheme, getColorTheme, setColorTheme, colorThemes } from './theme.svelte';
 export type { ThemeMode, ColorTheme } from './theme.svelte';
+export { setUnsavedChanges, getUnsavedChanges, initUnsavedChangesNotifier } from './unsaved-changes.svelte';
+export { setAdminOptions, getAdminOptions, getTextTransformers } from './options';
+export type { AdminOptions, TextTransformers, OvertimeConfig } from './options';
 
+export * from './query-keys';
+export { HttpError } from './types';
 export type {
   DataProvider, AuthProvider, NotificationProvider, MutationMode,
+  ValidationErrors, CrudOperator, LogicalFilter,
+  CustomParams, CustomResult,
   GetListParams, GetListResult,
   GetOneParams, GetOneResult,
   GetManyParams, GetManyResult,
@@ -40,16 +56,19 @@ export type {
   UpdateManyParams, UpdateManyResult,
   DeleteParams, DeleteResult,
   DeleteManyParams, DeleteManyResult,
-  CustomParams, CustomResult,
   Pagination, Sort, Filter, Identity,
   ResourceDefinition, FieldDefinition,
   AuthActionResult, CheckResult,
+  ResourceTypeMap, KnownResources, InferData,
+  BaseRecord,
 } from './types';
-export type { LiveProvider, LiveEvent } from './live';
+export type { InvalidateScope } from './options';
+export type { LiveProvider, LiveEvent, LiveMode } from './live';
 export type { Action, AccessControlResult, AccessControlFn } from './permissions';
 export type { AuditEntry, AuditHandler } from './audit';
 export { useCan } from './useCan';
 export { useExport, useImport } from './data-transfer';
+export type { UseExportOptions, UseImportOptions } from './data-transfer';
 export {
   useLogin, useLogout,
   useRegister, useForgotPassword, useUpdatePassword,
@@ -57,7 +76,21 @@ export {
   useOnError, usePermissions,
 } from './auth-hooks.svelte';
 export { useParsed } from './useParsed';
+export * from './useStepsForm.svelte';
 export { createHashRouterProvider, createHistoryRouterProvider } from './router-provider';
 export type { RouterProvider } from './router-provider';
 export { inferFieldType, inferResource } from './inferencer';
 export type { InferResult } from './inferencer';
+export { createWebSocketLiveProvider } from './live-websocket';
+export type { WebSocketLiveProviderOptions } from './live-websocket';
+export { createSSELiveProvider } from './live-sse';
+export type { SSELiveProviderOptions } from './live-sse';
+export { inferFromOpenAPI } from './inferencer-openapi';
+export type { InferFromOpenAPIOptions } from './inferencer-openapi';
+export {
+  getDefaultFilter, getDefaultSortOrder,
+  unionFilters, unionSorters,
+  file2Base64, generateDefaultDocumentTitle,
+} from './helpers';
+export { TableState } from './table-state.svelte';
+export type { TableStateOptions } from './table-state.svelte';

package/src/inferencer-openapi.test.ts

@@ -0,0 +1,192 @@
+/**
+ * Tests for OpenAPI → ResourceDefinition inference
+ */
+import { describe, test, expect } from 'bun:test';
+import { inferFromOpenAPI } from './inferencer-openapi';
+
+const sampleOpenAPI = {
+  openapi: '3.0.0',
+  info: { title: 'Blog API', version: '1.0.0' },
+  paths: {
+    '/api/posts': {
+      get: { operationId: 'getPosts' },
+      post: { operationId: 'createPost' },
+    },
+    '/api/posts/{id}': {
+      get: { operationId: 'getPost' },
+      put: { operationId: 'updatePost' },
+      delete: { operationId: 'deletePost' },
+    },
+    '/api/users': {
+      get: { operationId: 'getUsers' },
+    },
+  },
+  components: {
+    schemas: {
+      Post: {
+        type: 'object',
+        required: ['title', 'content'],
+        properties: {
+          id: { type: 'integer' },
+          title: { type: 'string' },
+          content: { type: 'string', description: 'Post body content' },
+          status: { type: 'string', enum: ['draft', 'published', 'archived'] },
+          author_id: { type: 'integer' },
+          email: { type: 'string', format: 'email' },
+          created_at: { type: 'string', format: 'date-time' },
+          tags: { type: 'array', items: { type: 'string' } },
+          is_featured: { type: 'boolean' },
+          views: { type: 'integer' },
+          website: { type: 'string', format: 'uri' },
+          meta: { type: 'object' },
+        },
+      },
+      User: {
+        type: 'object',
+        properties: {
+          id: { type: 'integer' },
+          name: { type: 'string' },
+          avatar: { type: 'string', format: 'uri' },
+        },
+      },
+    },
+  },
+};
+
+describe('inferFromOpenAPI', () => {
+  test('parses both schemas', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    expect(resources.length).toBe(2);
+  });
+
+  test('resource name is pluralized and lowercase', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts');
+    expect(post).toBeDefined();
+    expect(post!.label).toBe('Post');
+  });
+
+  test('detects required fields', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const titleField = post.fields.find(f => f.key === 'title')!;
+    const viewsField = post.fields.find(f => f.key === 'views')!;
+    expect(titleField.required).toBe(true);
+    expect(viewsField.required).toBeFalsy();
+  });
+
+  test('maps integer to number type', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const viewsField = post.fields.find(f => f.key === 'views')!;
+    expect(viewsField.type).toBe('number');
+  });
+
+  test('maps boolean type', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'is_featured')!;
+    expect(field.type).toBe('boolean');
+  });
+
+  test('maps date-time format to date', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'created_at')!;
+    expect(field.type).toBe('date');
+  });
+
+  test('maps email format', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'email')!;
+    expect(field.type).toBe('email');
+  });
+
+  test('maps uri format to url', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'website')!;
+    expect(field.type).toBe('url');
+  });
+
+  test('maps enum to select with options', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'status')!;
+    expect(field.type).toBe('select');
+    expect(field.options!.length).toBe(3);
+    expect(field.options![0].value).toBe('draft');
+  });
+
+  test('maps array of strings to tags', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'tags')!;
+    expect(field.type).toBe('tags');
+  });
+
+  test('maps object to json', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'meta')!;
+    expect(field.type).toBe('json');
+  });
+
+  test('detects relation from _id suffix', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'author_id')!;
+    expect(field.type).toBe('relation');
+    expect(field.resource).toBe('authors');
+  });
+
+  test('detects CRUD capabilities from paths', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    expect(post.canCreate).toBe(true);
+    expect(post.canEdit).toBe(true);
+    expect(post.canDelete).toBe(true);
+    expect(post.canShow).toBe(true);
+  });
+
+  test('read-only resource has limited capabilities', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const user = resources.find(r => r.name === 'users')!;
+    expect(user.canShow).toBe(true);
+    expect(user.canCreate).toBe(false);
+    expect(user.canDelete).toBe(false);
+  });
+
+  test('include filter works', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI, { include: ['Post'] });
+    expect(resources.length).toBe(1);
+    expect(resources[0].name).toBe('posts');
+  });
+
+  test('exclude filter works', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI, { exclude: ['User'] });
+    expect(resources.length).toBe(1);
+    expect(resources[0].name).toBe('posts');
+  });
+
+  test('content field is detected as textarea from key name hint', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const field = post.fields.find(f => f.key === 'content')!;
+    expect(field.type).toBe('textarea');
+    expect(field.showInList).toBe(false);
+  });
+
+  test('id field excluded from form', () => {
+    const resources = inferFromOpenAPI(sampleOpenAPI);
+    const post = resources.find(r => r.name === 'posts')!;
+    const idField = post.fields.find(f => f.key === 'id')!;
+    expect(idField.showInForm).toBe(false);
+  });
+
+  test('empty spec returns empty array', () => {
+    const resources = inferFromOpenAPI({});
+    expect(resources.length).toBe(0);
+  });
+});