plugin-data-source-mssql 1.9.48 → 2.0.0

package/README.md

@@ -1,69 +1,75 @@
-# @gemvn90/plugin-data-source-mssql
+# plugin-data-source-mssql
 
-External MSSQL (Microsoft SQL Server) data source plugin for NocoBase.
+External MSSQL (Microsoft SQL Server) data source plugin for NocoBase 2.x.
 
 ## Features
 
 ### 🔌 External Data Source Integration
-- Connect to external Microsoft SQL Server databases
-- Automatically introspect and import database schema (tables, columns, types)
-- Support for multiple schemas within a single database
-- Schema-prefixed collection naming (`schema_tableName`)
+- Connect to external Microsoft SQL Server databases as a NocoBase data source
+- Extends `SequelizeDataSource` — fully integrated with the core persistence pipeline
+- Collections are **persisted** across app restarts via `dataSourcesCollections` metadata table
+- Support for multiple schemas and table prefix filtering
 
 ### 📊 Collection Management
-- **Load All Collections**: Automatically load all tables from the database
-- **Selective Loading**: Choose specific tables to import
-- **Schema Introspection**: Automatic field type detection and mapping to NocoBase field types
-- **Primary Key Detection**: Automatically identifies primary keys from table constraints
-
-### ⚡ Performance Optimizations
-
-#### Cursor-Based Pagination
-Optimized for querying large datasets (millions of rows):
-
-```typescript
-// Using MssqlRepository.chunkWithCursor()
-await repository.chunkWithCursor({
-  chunkSize: 1000,
-  callback: async (rows) => {
-    // Process each chunk
-  }
-});
-```
-
-**Benefits:**
-- Avoids `OFFSET/FETCH` performance degradation on deep pages
-- Auto-detects best cursor strategy based on table indexes
-- Supports composite primary keys and unique indexes
-- O(1) complexity regardless of page position
+- **Automatic Introspection**: Discover all tables from the external database via `readTables()`
+- **Selective Loading**: Choose specific tables to import via `loadTables()`
+- **Field Type Mapping**: MSSQL types automatically mapped to NocoBase field types
+- **Primary Key Detection**: Auto-detects PKs via Sequelize + fallback `sys.indexes` query
 
 ### 🗄️ Data Type Mapping
 
-| MSSQL Type | NocoBase Type | Interface |
-|------------|---------------|-----------|
-| `int`, `bigint`, `smallint`, `tinyint` | integer | integer |
-| `decimal`, `numeric`, `money` | decimal | |
-| `float`, `real` | double | |
-| `varchar`, `nvarchar`, `char`, `nchar` | string | input / textarea |
-| `text`, `ntext` | text | textarea |
-| `bit` | boolean | checkbox |
-| `date` | date | date |
-| `time` | time | time |
-| `datetime`, `datetime2`, `smalldatetime` | datetime | datetime |
-| `uniqueidentifier` | uuid | input |
-| `varbinary`, `binary`, `image` | json | |
+| MSSQL Type | NocoBase Type | UI Component |
+|------------|---------------|--------------|
+| `int`, `bigint`, `smallint`, `tinyint` | integer / bigInt | InputNumber |
+| `decimal`, `numeric`, `money` | decimal | InputNumber |
+| `float`, `real` | float | InputNumber |
+| `varchar`, `nvarchar`, `char`, `nchar` | string | Input |
+| `text`, `ntext` | text | Input.TextArea |
+| `bit` | boolean | Checkbox |
+| `date` | dateOnly | DatePicker |
+| `time` | time | TimePicker |
+| `datetime`, `datetime2`, `smalldatetime` | datetimeNoTz | DatePicker |
+| `datetimeoffset` | datetimeTz | DatePicker |
+| `uniqueidentifier` | uuid | Input |
+
+### ⚡ Performance
+- **Cursor-Based Pagination**: `MssqlSmartCursorBuilder` for efficient large dataset queries
+- Avoids `OFFSET/FETCH` degradation on deep pages
+- Auto-detects best cursor strategy based on table indexes
 
 ### 🕐 DateTime Handling
 - Automatic conversion of JavaScript `Date` objects to MSSQL-compatible format
-- Timezone-aware date filtering support
-- Fixes "Conversion failed when converting date and/or time from character string" errors
+- `beforeFind`/`beforeCount` hooks transform date values in WHERE clauses
+- Preserves Sequelize operator symbols (`Op.and`, `Op.like`, etc.) using `Reflect.ownKeys()`
 
 ### 🔒 Security
 - Encrypted connection support (`encrypt` option)
 - Configurable connection pooling
 - Secure credential handling
 
-## Configuration Options
+## Architecture
+
+```
+plugin-data-source-mssql/
+├── src/server/
+│   ├── plugin.ts                    # Plugin registration + destroy middleware
+│   ├── data-source/
+│   │   ├── MssqlExternalDataSource.ts   # Main class (extends SequelizeDataSource)
+│   │   ├── MssqlIntrospector.ts         # MSSQL-specific DatabaseIntrospector
+│   │   ├── MssqlCollectionManager.ts    # Collection manager with MSSQL repo
+│   │   ├── MssqlRepository.ts           # Repository with cursor pagination
+│   │   └── MssqlSmartCursorBuilder.ts   # Cursor-based query builder
+│   ├── controllers/
+│   │   └── ExternalMssqlController.ts   # testConnection API
+│   └── dialects/
+│       └── mssql-dialect.ts             # MSSQL dialect registration
+├── src/client/
+│   └── ...                              # Configuration UI components
+└── scripts/
+    └── copy-tedious.js                  # Embeds tedious + deps into dist/
+```
+
+## Configuration
 
 ```typescript
 interface MssqlDataSourceOptions {
@@ -92,28 +98,15 @@ interface MssqlDataSourceOptions {
 
 ## API Endpoints
 
-### Test Connection
-```
-POST /api/external-mssql:testConnection
-```
-
-### List Available Tables (Preview)
-```
-POST /api/dataSources:readTables
-Body: { type: 'mssql', options: { host, database, ... } }
-```
-
-### Collection Operations
-Standard NocoBase data source collection operations are supported:
-- `GET /api/:collectionName:list`
-- `GET /api/:collectionName:get`
-- `POST /api/:collectionName:create`
-- `POST /api/:collectionName:update`
-- `POST /api/:collectionName:destroy`
+| Endpoint | Description |
+|----------|-------------|
+| `POST /api/external-mssql:testConnection` | Test MSSQL connection |
+| `GET /api/dataSources.collections:list` | List loaded collections |
+| Standard CRUD via data source routing | `list`, `get`, `create`, `update`, `destroy` |
 
 ## Requirements
 
-- NocoBase >= 1.0.0
+- NocoBase >= 2.0.0
 - Microsoft SQL Server 2012 or later
 - Node.js >= 18
 
@@ -121,12 +114,12 @@ Standard NocoBase data source collection operations are supported:
 
 ```bash
 # From tgz file
-yarn pm add ./path/to/gemvn90-plugin-data-source-mssql-x.x.x.tgz
+yarn pm add ./plugin-data-source-mssql-2.0.0.tgz
 
-# Then enable the plugin
-yarn pm enable @gemvn90/plugin-data-source-mssql
+# Enable the plugin
+yarn pm enable plugin-data-source-mssql
 ```
 
 ## License
 
-AGPL-3.0 / NocoBase Commercial License
+MIT

package/dist/server/data-source/MssqlExternalDataSource.js

@@ -206,8 +206,8 @@ class MssqlExternalDataSource extends import_data_source_manager.SequelizeDataSo
         return obj.map((item) => transformDatesInObject(item, Sq));
       }
       const result = {};
-      for (const [key, value] of Object.entries(obj)) {
-        result[key] = transformDatesInObject(value, Sq);
+      for (const key of Reflect.ownKeys(obj)) {
+        result[key] = transformDatesInObject(obj[key], Sq);
       }
       return result;
     };

package/package.json

@@ -3,9 +3,9 @@
   "displayName": "Data source: MSSQL",
   "displayName.ru-RU": "Источник данных: MSSQL",
   "displayName.zh-CN": "数据源：MSSQL",
-  "version": "1.9.48",
+  "version": "2.0.0",
   "description": "External MSSQL data source support for NocoBase.",
-  "license": "AGPL-3.0",
+  "license": "MIT",
   "main": "./dist/server/index.js",
   "scripts": {
     "postbuild": "node ./scripts/copy-tedious.js",