@foxford/den 3.1.0 → 3.1.2

package/den-serve.js

@@ -1,146 +0,0 @@
-#!/usr/bin/env node
-
-import { resolve } from 'node:path'
-import { pathToFileURL } from 'node:url'
-
-// Команда, поднимающая приложение сервисом. Ради неё потребителю не нужен свой серверный файл:
-// он объявляет дескриптор через `defineApp` и запускает `den-serve` — сервер внутрь дескриптора
-// при этом не заезжает.
-//
-// Внутрь его класть нельзя: `defineApp` импортирует ХОСТ, чтобы поднять приложение у себя в
-// процессе, и вместе с дескриптором к нему приехали бы fastify и `node:http` — в серверный
-// бандл и в браузерный. Дескриптор к тому же перестал бы быть данными, а инвариант
-// «приложение не знает своего класса» сломался бы: дескриптор, поднимающий сервер, знает,
-// что он сетевой.
-//
-// Watch внутри команды нет намеренно: приложение всё равно собирается сборщиком потребителя,
-// и он же умеет перезапускать (`tsup --watch --onSuccess "den-serve build/index.js"`). Второй
-// сторож поверх первого только путал бы.
-//
-// Обычный `.js`, а не собираемый исходник: команда должна работать одинаково из воркспейса и
-// из опубликованного пакета, а `@foxford/den/serve` — self-reference по имени пакета, поэтому
-// в обоих случаях резолвится своим `exports`.
-//
-// Shebang здесь — `tsx`, потому что в воркспейсе `exports` ведут на `src/*.ts`. В артефакт
-// файл кладётся сборкой с заменой на `node`: там те же `exports` ведут уже на собранный js
-// (см. `installCli` в tsup.config.ts).
-
-const USAGE = `den-serve <модуль> [опции]
-
-  <модуль>              путь к модулю, чей дефолтный экспорт — дескриптор приложения
-
-  --port <порт>         порт (по умолчанию PORT из окружения либо 3000)
-  --host <адрес>        интерфейс прослушивания (по умолчанию HOST либо 0.0.0.0)
-  --slow <мс>           порог медленного рендера для лога (по умолчанию 1000)
-  --configure <модуль>  модуль, чей дефолтный экспорт получает инстанс fastify до
-                        прослушивания: Sentry, метрики, cors — сюда
-  -h, --help            эта справка
-`
-
-function parseArgs(argv) {
-  const options = {}
-  let entry
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i]
-    switch (arg) {
-      case '-h':
-      case '--help':
-        return { help: true }
-      case '--port':
-      case '--host':
-      case '--slow':
-      case '--configure':
-        i += 1
-        options[arg.slice(2)] = argv[i]
-        break
-      default:
-        if (arg.startsWith('-')) {
-          throw new Error(`неизвестная опция ${arg}`)
-        }
-        if (entry !== undefined) {
-          throw new Error('модуль указывается один')
-        }
-        entry = arg
-    }
-  }
-
-  return { entry, options }
-}
-
-function fail(message) {
-  process.stderr.write(`den-serve: ${message}\n\n${USAGE}`)
-  process.exit(1)
-}
-
-/**
- * Достаёт дескриптор из указанного модуля.
- *
- * Форма проверяется ДО подъёма сервера: иначе первая же ошибка вылезла бы на запросе, из
- * середины рендера, и выглядела бы как проблема приложения, а не запуска.
- */
-async function loadApp(entry) {
-  const module = await import(pathToFileURL(resolve(process.cwd(), entry)).href)
-  const app = module.default
-
-  if (typeof app !== 'object' || app === null || typeof app.name !== 'string') {
-    fail(`дефолтный экспорт «${entry}» не похож на дескриптор приложения`)
-  }
-
-  return app
-}
-
-/**
- * Достаёт расширение инстанса из указанного модуля.
- *
- * Отдельной опцией, а не соглашением об имени файла: команда не должна угадывать, что в
- * проекте считается конфигом. Без неё «серверного файла не нужно» и «расширяется снаружи»
- * не сходились бы — за первым же плагином потребитель писал бы свою точку входа.
- */
-async function loadConfigure(entry) {
-  const module = await import(pathToFileURL(resolve(process.cwd(), entry)).href)
-
-  if (typeof module.default !== 'function') {
-    fail(`дефолтный экспорт «${entry}» не функция — расширять инстанс нечем`)
-  }
-
-  return module.default
-}
-
-async function main() {
-  // Разбор аргументов — единственное место, где ошибка означает «человек опечатался»,
-  // поэтому она показывается подсказкой, а не стектрейсом
-  let parsed
-  try {
-    parsed = parseArgs(process.argv.slice(2))
-  } catch (error) {
-    fail(error.message)
-  }
-
-  const { entry, help, options = {} } = parsed
-
-  if (help) {
-    process.stdout.write(USAGE)
-    return
-  }
-
-  if (entry === undefined) {
-    fail('не указан модуль с дескриптором')
-  }
-
-  // Рантайм грузится ПОСЛЕ разбора аргументов: `--help` и опечатка в опции не должны тянуть
-  // fastify и весь серверный граф
-  const { serveApp } = await import('@foxford/den/serve')
-
-  await serveApp(await loadApp(entry), {
-    configure: options.configure === undefined ? undefined : await loadConfigure(options.configure),
-    host: options.host ?? process.env.HOST ?? '0.0.0.0',
-    port: Number(options.port ?? process.env.PORT ?? 3000),
-    slowRenderMs: options.slow === undefined ? undefined : Number(options.slow),
-  })
-}
-
-main().catch((error) => {
-  process.stderr.write(`den-serve: ${error instanceof Error ? error.message : String(error)}\n`)
-  process.exit(1)
-})