@nitra/cursor 1.8.216 → 1.8.217

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.217] - 2026-05-09
+
+### Added
+
+- **js-run / conn-нейминг:** префікс `mssql-` тепер прийнятний у `src/conn/` нарівні з `mysql-` (`mssql-read.js`, `mssql-write-<id>.js` тощо). Сам npm-пакет `mssql` і раніше згадувався у правилі (як драйвер для MS SQL Server), але філенейм ставився під спільний `mysql-` префікс — це плутало читачів коду, де `import sql from 'mssql'` сусідив з файлом `mysql-write.js`. Тепер MSSQL має власний префікс із власним camelCase-експортом (`mssql-write-b2b` → `mssqlWriteB2b`). **Backward-compat:** проєкти, що вже використовують `mysql-…` для MSSQL-файлів, валідні без змін; рекомендований, але не обов'язковий рефактор — `git mv` цих файлів на `mssql-…` і відповідне перейменування іменованого експорту (`mysqlWrite` → `mssqlWrite`) зі оновленням імпортів через `#conn/*`.
+- Регекс `CONN_FILENAME_RE` у `npm/scripts/utils/conn-file-rules.mjs` розширено до `(pg|mysql|mssql)-(read|write)(-<id>)?`; повідомлення про порушення в `npm/scripts/check-js-run.mjs` оновлено під чотири альтернативи; `mdc/js-run.mdc` має окремі пункти для MySQL і MSSQL.
+- Тести: `npm/tests/conn-file-rules.test.mjs` (юніт-тести `isConnFileNameValid` / `kebabToCamel` / `findConnFileRuleViolations` під `mssql-`) та два інтеграційні кейси у `npm/tests/check-js-run-fixture.test.mjs` (`mssql-write.js` з валідним і невалідним експортом).
+
 ## [1.8.216] - 2026-05-09
 
 ### Changed

package/mdc/js-run.mdc

@@ -134,7 +134,8 @@ import { gql, graphQLClient } from '@nitra/graphql-request'
 - **PostgreSQL до кількох БД** — додатково ідентифікатор підключення після типу:
   - `src/conn/pg-read-smart.js`
   - `src/conn/pg-write-contract.js`
-- **MySQL / MSSQL** — префікс `mysql-` за тією ж схемою (`mysql-read.js`, `mysql-write-<id>.js` тощо).
+- **MySQL** — префікс `mysql-` за тією ж схемою (`mysql-read.js`, `mysql-write-<id>.js` тощо).
+- **MSSQL** — префікс `mssql-` за тією ж схемою (`mssql-read.js`, `mssql-write-<id>.js` тощо). Хоча npm-пакет один (`mssql`), а драйвер MS SQL Server під капотом T-SQL — у файловій назві відрізняємо MS SQL Server від MySQL, бо це різні СУБД, різні діалекти, різні рантаймні залежності. Якщо проєкт історично використовує `mysql-…` для MSSQL-підключень — він валідний і далі (для backward-compat), але новий код пишемо з префіксом `mssql-`.
 
 Підключення до БД **обов'язково** має бути ідентифіковано як `read` (репліка) або `write` (мастер). Якщо з імені змінної оточення (наприклад, `env.PG_CONN`) це не очевидно — визнач режим за операціями в коді: якщо немає операцій зміни даних (`INSERT`/`UPDATE`/`DELETE`/DDL) — це `pg-read.js`, інакше `pg-write.js`.
 
@@ -232,7 +233,7 @@ on:
 
 `npx @nitra/cursor check js-run` — зокрема для кожного backend workspace-пакета з каталогом **`src/`** перевіряє наявність **`jsconfig.json`** і збіг вмісту з каноном вище. Додатково для файлів у каталозі `#conn/` (за замовчуванням `src/conn/`) перевіряється:
 
-- **basename файла** відповідає канону: `ql-<id>` (GraphQL) / `(pg|mysql)-(read|write)[-<id>]` (БД), kebab-case `[a-z0-9-]`;
+- **basename файла** відповідає канону: `ql-<id>` (GraphQL) / `(pg|mysql|mssql)-(read|write)[-<id>]` (БД), kebab-case `[a-z0-9-]`;
 - **відсутній `export default`** — лише іменований експорт;
 - **імʼя експорту** дорівнює camelCase від basename (`pg-write-contract.js` → `export const pgWriteContract`).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.216",
+  "version": "1.8.217",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/check-js-run.mjs

@@ -13,7 +13,7 @@
  *    `package.json#imports['#conn/*']` — у його цільовому каталозі); поза ним — порушення
  *    (див. `utils/conn-imports-scan.mjs`);
  *  - «Нейминг та експорти у `#conn/`»: всередині conn-каталогу basename файла має відповідати
- *    канону `ql-<id>` / `(pg|mysql)-(read|write)[-<id>]`; `export default` заборонений; має бути
+ *    канону `ql-<id>` / `(pg|mysql|mssql)-(read|write)[-<id>]`; `export default` заборонений; має бути
  *    іменований експорт з імʼям, що дорівнює camelCase від basename файла (`pg-write-contract.js`
  *    → `export const pgWriteContract`); `index.*` як reexport-барель пропускаємо
  *    (див. `utils/conn-file-rules.mjs`);
@@ -192,7 +192,7 @@ async function checkConnImports(absPackageRoot, sourcePaths, pkgJson, label, fai
 /**
  * Перевіряє правила нейминга та експортів для файлів усередині `#conn/`.
  *
- * Канон імені: `ql-<id>` для GraphQL, `(pg|mysql)-(read|write)[-<id>]` для БД (js-run.mdc,
+ * Канон імені: `ql-<id>` для GraphQL, `(pg|mysql|mssql)-(read|write)[-<id>]` для БД (js-run.mdc,
  * розділ «Нейминг файлів у `src/conn/`»). Експорт у файлі — лише іменований, з імʼям, що
  * дорівнює camelCase від basename файла (`pg-write-contract.js` → `export const pgWriteContract`).
  * @param {string} absPackageRoot абсолютний корінь пакета
@@ -219,7 +219,8 @@ async function checkConnFileNamingAndExports(absPackageRoot, sourcePaths, pkgJso
       if (v.kind === 'name') {
         fail(
           `${label}${rel} — назва файла в '${connDir}/' не відповідає канону js-run: ` +
-            `'ql-<id>', 'pg-{read|write}[-<id>]' або 'mysql-{read|write}[-<id>]' (kebab-case, [a-z0-9-])`
+            `'ql-<id>', 'pg-{read|write}[-<id>]', 'mysql-{read|write}[-<id>]' або 'mssql-{read|write}[-<id>]' ` +
+            `(kebab-case, [a-z0-9-])`
         )
       } else if (v.kind === 'default-export') {
         fail(`${label}${rel} — 'export default' заборонений у '${connDir}/'; зроби іменований експорт`)
@@ -326,7 +327,7 @@ async function checkWorkspacePackage(rootDir, ignorePaths, workflows, fail, pass
   if (connFileViolations === 0) {
     const connDir = resolveConnDirFromPackageJson(pkgJson)
     passFn(
-      `${label}файли в '${connDir}/' дотримують канону js-run: нейминг (ql-/pg-/mysql-…) і іменований експорт у camelCase від basename`
+      `${label}файли в '${connDir}/' дотримують канону js-run: нейминг (ql-/pg-/mysql-/mssql-…) і іменований експорт у camelCase від basename`
     )
   }
 

package/scripts/utils/conn-file-rules.mjs

@@ -5,7 +5,8 @@
  * Канонічна назва файла:
  *  - GraphQL: `ql-<id>.{js|mjs|cjs|ts|mts|cts}` (id — kebab-case ідентифікатор endpoint);
  *  - PostgreSQL: `pg-{read|write}.{ext}` або `pg-{read|write}-<id>.{ext}` (id — для multi-БД);
- *  - MySQL/MSSQL: `mysql-{read|write}.{ext}` або `mysql-{read|write}-<id>.{ext}`.
+ *  - MySQL: `mysql-{read|write}.{ext}` або `mysql-{read|write}-<id>.{ext}`;
+ *  - MSSQL: `mssql-{read|write}.{ext}` або `mssql-{read|write}-<id>.{ext}`.
  *
  * Канонічний експорт — іменований, без `export default`. Імʼя константи має дорівнювати
  * camelCase від basename файла (`pg-write-contract` → `pgWriteContract`).
@@ -20,11 +21,11 @@ const SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/u
 /**
  * Канонічний шаблон імені файла в каталозі conn.
  *  - `ql-<id>` для GraphQL;
- *  - `(pg|mysql)-(read|write)(-<id>)?` для БД.
+ *  - `(pg|mysql|mssql)-(read|write)(-<id>)?` для БД.
  * `<id>` — починається з [a-z0-9], далі [a-z0-9-]*.
  */
 const CONN_FILENAME_RE =
-  /^(?:ql-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|(?:pg|mysql)-(?:read|write)(?:-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?)\.([cm]?[jt]sx?)$/u
+  /^(?:ql-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|(?:pg|mysql|mssql)-(?:read|write)(?:-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?)\.([cm]?[jt]sx?)$/u
 
 /**
  * Чи це файл, який сканується правилом «conn-file» (JS/TS-сімʼя, без `.d.ts`).