Node.js 25 TypeScript, SQLite и модель разрешений:
Полное руководство для production

1. Обзор и версионная хронология

Node.js 25+ привносит три революционных нативных возможности в JavaScript-рантайм: нативную поддержку TypeScript через встроенный type stripping, встроенный SQLite через модуль node:sqlite и модель разрешений (Permission Model) для гранулярной безопасности во время выполнения. В этом руководстве подробно рассматриваются все три функции.

Главный вывод: Начиная с Node.js 25+ (Current) и Node.js 24+ (LTS), все три функции стабильны и готовы к production-использованию.

2. Нативная поддержка TypeScript (Type Stripping)

2.1 Включение TypeScript в Node.js

Есть два способа запускать TypeScript-код в Node.js:

Встроенный type stripping работает по умолчанию — просто запустите:

# Запустить TypeScript-файл напрямую (Node.js 22+)
node app.ts

# Флаги не нужны — type stripping включён по умолчанию в v22+

Чтобы отключить type stripping:

node --no-strip-types app.ts

2.2 Как работает type stripping

Node.js выполняет TypeScript-файлы, заменяя TypeScript-специфичный синтаксис на пробелы (сохраняя номера строк и столбцов в stack trace). Проверка типов не выполняется — это по-прежнему задача tsc в редакторе или CI.

Ключевые принципы:

• Нет проверки типов во время выполнения — Node.js не валидирует типы, только удаляет их
• Не нужны source maps — замена на пробелы сохраняет номера строк
• tsconfig.json не читается — Node.js полностью игнорирует файлы tsconfig.json
• Лёгковесность — поддерживается только удаляемый синтаксис
• Совместимость с TypeScript 5.8+

// Этот код выполняется нативно в Node.js:
function greet(name: string): string {
  return `Hello, ${name}!`;
}

// Аннотации типа `: string` заменяются на пробелы
// Node.js видит: function greet(name) { return `Hello, ${name}!`; }

2.3 Поддерживаемые расширения файлов и модульная система

Правила модульной системы для .ts-файлов:

• Добавьте "type": "module" в ваш package.json
• Без "type": "module" файлы .ts по умолчанию используют CommonJS
• Расширения файлов обязательны в импортах

// Правильно:
import './helper.ts';
import { config } from './config.ts';

// Неправильно — будет ошибка:
import './helper';
import { config } from './config';

// Также правильно для CommonJS:
const helper = require('./helper.ts');

2.4 Возможности TypeScript, которые работают и не работают

2.5 Импорт типов (ключевое слово type)

Из-за того, как работает type stripping, ключевое слово type обязательно в импортах:

// ✅ Правильно — будет работать:
import type { User, Config } from './types.ts';
import { createUser, type UserInput } from './user.ts';

// ❌ Неправильно — будет runtime-ошибка:
import { User, Config } from './types.ts'; // User — тип, а не значение

2.6 Рекомендуемые настройки tsconfig.json

Для проектов, нацеленных на Node.js 25+ со встроенным type stripping:

{
  "compilerOptions": {
    "noEmit": true,
    "target": "esnext",
    "module": "nodenext",
    "rewriteRelativeImportExtensions": true,
    "erasableSyntaxOnly": true,
    "verbatimModuleSyntax": true
  }
}

2.7 Полная поддержка TypeScript через сторонние инструменты

# Установка как dev-зависимости
npm install --save-dev tsx

# Запуск напрямую
npx tsx your-file.ts

# Или через node --import
node --import=tsx your-file.ts

2.8 Type Stripping в зависимостях и не-файловых входах

Зависимости внутри node_modules: Node.js отказывается обрабатывать TypeScript-файлы внутри node_modules.

Не-файловые входы:

• --eval и STDIN: type stripping работает
• REPL: Не поддерживается
• --check: Не поддерживается

Путевые алиасы: paths из tsconfig.json не поддерживаются. Используйте subpath imports.

3. Встроенный SQLite (node:sqlite)

3.1 Обзор

• Модуль: node:sqlite
• Доступен с: Node.js v22.5.0
• Статус: Стабильный в Node.js 24+ (LTS)
• Стиль API: Синхронный (DatabaseSync, StatementSync)
• Движок: Встроенный SQLite (без внешних зависимостей)

import { DatabaseSync } from 'node:sqlite';

const db = new DatabaseSync(':memory:');
db.exec(`
  CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT UNIQUE
  );
`);

3.2 Класс DatabaseSync

new DatabaseSync(filename[, options])

Методы: db.prepare(sql), db.exec(sql), db.export(), db.backup(), db.close(), db.serialize(), db.transaction(), db.aggregate(), db.loadExtension(), db.enableDefensive().

3.3 Класс StatementSync

Методы: stmt.run(values) → {lastInsertRowid, changes}, stmt.get(values) → первая строка, stmt.all(values) → все строки, stmt.iterate(values) → итератор.

// INSERT
const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
const result = insert.run('Alice', '[email protected]');
console.log(result.lastInsertRowid); // 1

// SELECT одной строки
const user = db.prepare('SELECT * FROM users WHERE id = ?').get(1);

// SELECT всех строк
const allUsers = db.prepare('SELECT * FROM users').all();

// Именованные параметры (префиксы $, @ или :)
const byEmail = db.prepare('SELECT * FROM users WHERE email = $email');
const user = byEmail.get({ $email: '[email protected]' });

3.4 Транзакции и сериализация

// Транзакция (атомарная, автооткат при ошибке)
const insertUser = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');

const insertUsers = db.transaction((users) => {
  for (const user of users) {
    insertUser.run(user.name, user.email);
  }
});

insertUsers([
  { name: 'Charlie', email: '[email protected]' },
  { name: 'Diana', email: '[email protected]' },
]);

// Сериализация
db.serialize(() => {
  db.exec('INSERT INTO users VALUES (1, "Alice")');
  db.exec('INSERT INTO users VALUES (2, "Bob")');
});

3.5 Бэкап и экспорт

// Бэкап с прогрессом
const db = new DatabaseSync('source.db');
db.backup('backup.db', {
  progress: (remaining, total) => {
    const pct = ((total - remaining) / total * 100).toFixed(2);
    console.log(`Backup: ${pct}%`);
  }
});

// Экспорт всей БД как Uint8Array
const data = db.export();

3.6 Полный пример кода

import { DatabaseSync } from 'node:sqlite';

const db = new DatabaseSync(':memory:');

db.exec(`
  CREATE TABLE projects (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    created_at TEXT DEFAULT (datetime('now'))
  );

  CREATE TABLE tasks (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    project_id INTEGER REFERENCES projects(id),
    title TEXT NOT NULL,
    done INTEGER DEFAULT 0
  );
`);

const insertProject = db.prepare('INSERT INTO projects (name) VALUES (?)');
const projectResult = insertProject.run('My Project');
const projectId = projectResult.lastInsertRowid;

const addTasks = db.transaction(() => {
  const insertTask = db.prepare('INSERT INTO tasks (project_id, title) VALUES (?, ?)');
  insertTask.run(projectId, 'Спроектировать схему БД');
  insertTask.run(projectId, 'Написать API-эндпоинты');
  insertTask.run(projectId, 'Протестировать приложение');
});
addTasks();

const tasks = db.prepare(`
  SELECT t.id, t.title, t.done, p.name as project
  FROM tasks t
  JOIN projects p ON t.project_id = p.id
  WHERE p.id = ?
`).all(projectId);
console.log(tasks);
db.close();

4. Модель разрешений (Permission Model)

4.1 Обзор и история

Модель разрешений Node.js — это механизм безопасности, ограничивающий доступ процесса Node.js к системным ресурсам.

4.2 Включение модели разрешений

# Включение модели (ограничивает все разрешения по умолчанию)
node --permission app.js

При включении --permission ограничиваются: доступ к ФС, сеть, дочерние процессы, Worker-потоки, нативные аддоны, WASI, FFI, Inspector-протокол.

4.3 Runtime API: process.permission

// Проверка разрешения
process.permission.has('fs.write');   // true | false
process.permission.has('fs.read', '/home/refs/protected-folder');

// Необратимый отзыв разрешения
process.permission.drop('fs.read', '/etc/myapp');
process.permission.drop('child');

4.4 Разрешения файловой системы

# Разрешить все операции с ФС
node --permission --allow-fs-read=* --allow-fs-write=* index.js

# Разрешить конкретные пути
node --permission --allow-fs-read=/tmp/ --allow-fs-write=/tmp/ index.js

5. FAQ (Часто задаваемые вопросы)

6. Ссылки и дополнительное чтение

Статьи на maximov.by:

• Модель разрешений Node.js: process.permission.drop() в Node 26.3 — подробное руководство по API модели разрешений
• Node.js 26: Temporal, V8 14.6, Undici 8 и гайд по миграции — полный гайд по миграции на Node.js 26
• Promise.try в Node.js — новый нативный Promise.try в Node.js 22+

Официальная документация:

• Node.js Modules: TypeScript
• Node.js SQLite
• Node.js Permissions

Нужно создать современное Node.js-приложение с TypeScript, SQLite и правильной безопасностью? Я — full-stack разработчик с глубоким опытом Node.js, TypeScript и production-архитектуры. Обсудим ваш проект.