@platformatic/control 3.0.0-alpha.1 → 3.0.0-alpha.2

package/README.md

@@ -1,6 +1,6 @@
 # @platformatic/control
 
-Check out the full documentation for Platformatic Runtime on [our website](https://docs.platformatic.dev/docs/guides/runtime-cli-managing).
+Check out the full documentation for Platformatic on [our website](https://docs.platformatic.dev).
 
 ## Install
 

package/eslint.config.js

@@ -1,3 +1,3 @@
-'use strict'
+import neostandard from 'neostandard'
 
-module.exports = require('neostandard')({})
+export default neostandard({})

package/lib/errors.d.ts

@@ -0,0 +1,21 @@
+import { FastifyError } from '@fastify/error'
+
+export declare const ERROR_PREFIX: string
+
+export declare const RuntimeNotFound: (value: string) => FastifyError
+export declare const ServiceNotFound: (value: string) => FastifyError
+export declare const MissingRequestURL: (value: string) => FastifyError
+export declare const FailedToGetRuntimeMetadata: (value: string) => FastifyError
+export declare const FailedToGetRuntimeServices: (value: string) => FastifyError
+export declare const FailedToGetRuntimeEnv: (value: string) => FastifyError
+export declare const FailedToGetRuntimeOpenapi: (value: string) => FastifyError
+export declare const FailedToStreamRuntimeLogs: (value: string) => FastifyError
+export declare const FailedToStopRuntime: (value: string) => FastifyError
+export declare const FailedToReloadRuntime: (value: string) => FastifyError
+export declare const FailedToGetRuntimeConfig: (value: string) => FastifyError
+export declare const FailedToGetRuntimeServiceEnv: (value: string) => FastifyError
+export declare const FailedToGetRuntimeServiceConfig: (value: string) => FastifyError
+export declare const FailedToGetRuntimeHistoryLogs: (value: string) => FastifyError
+export declare const FailedToGetRuntimeAllLogs: (value: string) => FastifyError
+export declare const FailedToGetRuntimeLogIndexes: (value: string) => FastifyError
+export declare const FailedToGetRuntimeMetrics: (value: string) => FastifyError

package/lib/errors.js

@@ -1,25 +1,79 @@
-'use strict'
-
-const createError = require('@fastify/error')
-
-const ERROR_PREFIX = 'PLT_CTR'
-
-module.exports = {
-  RuntimeNotFound: createError(`${ERROR_PREFIX}_RUNTIME_NOT_FOUND`, 'Runtime not found.'),
-  ServiceNotFound: createError(`${ERROR_PREFIX}_SERVICE_NOT_FOUND`, 'Service not found.'),
-  MissingRequestURL: createError(`${ERROR_PREFIX}_MISSING_REQUEST_URL`, 'Request URL is required.'),
-  FailedToGetRuntimeMetadata: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_METADATA`, 'Failed to get runtime metadata %s.'),
-  FailedToGetRuntimeServices: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICES`, 'Failed to get runtime services %s.'),
-  FailedToGetRuntimeEnv: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_ENV`, 'Failed to get runtime environment variables %s.'),
-  FailedToGetRuntimeOpenapi: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_OPENAPI`, 'Failed to get runtime OpenAPI schema %s.'),
-  FailedToStreamRuntimeLogs: createError(`${ERROR_PREFIX}_FAILED_TO_STREAM_RUNTIME_LOGS`, 'Failed to stream runtime logs %s.'),
-  FailedToStopRuntime: createError(`${ERROR_PREFIX}_FAILED_TO_STOP_RUNTIME`, 'Failed to stop the runtime %s.'),
-  FailedToReloadRuntime: createError(`${ERROR_PREFIX}_FAILED_TO_RELOAD_RUNTIME`, 'Failed to reload the runtime %s.'),
-  FailedToGetRuntimeConfig: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_CONFIG`, 'Failed to get runtime config %s.'),
-  FailedToGetRuntimeServiceEnv: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICE_ENV`, 'Failed to get runtime service environment variables %s.'),
-  FailedToGetRuntimeServiceConfig: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICE_CONFIG`, 'Failed to get runtime service config %s.'),
-  FailedToGetRuntimeHistoryLogs: createError(`${ERROR_PREFIX}_FAILED_TO_GET_HISTORY_LOGS`, 'Failed to get history logs %s.'),
-  FailedToGetRuntimeAllLogs: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_ALL_LOGS`, 'Failed to get runtime all logs %s.'),
-  FailedToGetRuntimeLogIndexes: createError(`${ERROR_PREFIX}_FAILED_TO_GET_HISTORY_LOGS_COUNT`, 'Failed to get history logs count %s.'),
-  FailedToGetRuntimeMetrics: createError(`${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_METRICS`, 'Failed to get runtime metrics %s.'),
-}
+import createError from '@fastify/error'
+
+export const ERROR_PREFIX = 'PLT_CTR'
+
+export const RuntimeNotFound = createError(`${ERROR_PREFIX}_RUNTIME_NOT_FOUND`, 'Runtime not found.')
+
+export const ServiceNotFound = createError(`${ERROR_PREFIX}_SERVICE_NOT_FOUND`, 'Service not found.')
+
+export const MissingRequestURL = createError(`${ERROR_PREFIX}_MISSING_REQUEST_URL`, 'Request URL is required.')
+
+export const FailedToGetRuntimeMetadata = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_METADATA`,
+  'Failed to get runtime metadata %s.'
+)
+
+export const FailedToGetRuntimeServices = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICES`,
+  'Failed to get runtime services %s.'
+)
+
+export const FailedToGetRuntimeEnv = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_ENV`,
+  'Failed to get runtime environment variables %s.'
+)
+
+export const FailedToGetRuntimeOpenapi = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_OPENAPI`,
+  'Failed to get runtime OpenAPI schema %s.'
+)
+
+export const FailedToStreamRuntimeLogs = createError(
+  `${ERROR_PREFIX}_FAILED_TO_STREAM_RUNTIME_LOGS`,
+  'Failed to stream runtime logs %s.'
+)
+
+export const FailedToStopRuntime = createError(
+  `${ERROR_PREFIX}_FAILED_TO_STOP_RUNTIME`,
+  'Failed to stop the runtime %s.'
+)
+
+export const FailedToReloadRuntime = createError(
+  `${ERROR_PREFIX}_FAILED_TO_RELOAD_RUNTIME`,
+  'Failed to reload the runtime %s.'
+)
+
+export const FailedToGetRuntimeConfig = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_CONFIG`,
+  'Failed to get runtime config %s.'
+)
+
+export const FailedToGetRuntimeServiceEnv = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICE_ENV`,
+  'Failed to get runtime service environment variables %s.'
+)
+
+export const FailedToGetRuntimeServiceConfig = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_SERVICE_CONFIG`,
+  'Failed to get runtime service config %s.'
+)
+
+export const FailedToGetRuntimeHistoryLogs = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_HISTORY_LOGS`,
+  'Failed to get history logs %s.'
+)
+
+export const FailedToGetRuntimeAllLogs = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_ALL_LOGS`,
+  'Failed to get runtime all logs %s.'
+)
+
+export const FailedToGetRuntimeLogIndexes = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_HISTORY_LOGS_COUNT`,
+  'Failed to get history logs count %s.'
+)
+
+export const FailedToGetRuntimeMetrics = createError(
+  `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_METRICS`,
+  'Failed to get runtime metrics %s.'
+)

package/lib/index.d.ts

@@ -0,0 +1,129 @@
+import { ChildProcess } from 'node:child_process'
+import { Readable } from 'node:stream'
+import { Dispatcher } from 'undici'
+import WebSocket from 'ws'
+
+export * from './errors.js'
+
+export type ReadableBody = Dispatcher.ResponseData['body']
+
+export class WebSocketStream extends Readable {
+  constructor (url: string)
+  ws: WebSocket
+}
+
+export interface RuntimeDependency {
+  id: string
+  url: string
+  local: boolean
+}
+
+export interface RuntimeServiceBase {
+  id: string
+  status: string
+}
+
+export interface RuntimeService {
+  id: string
+  type: string
+  status: string
+  version: string
+  localUrl: string
+  entrypoint: boolean
+  url?: string
+  workers?: number
+  dependencies: Runtime
+}
+
+export interface Runtime {
+  pid: number
+  cwd: string
+  argv: string[]
+  uptimeSeconds: number
+  execPath: string
+  nodeVersion: string
+  projectDir: string
+  packageName: string | null
+  packageVersion: string | null
+  url: string | null
+  platformaticVersion: string
+}
+
+export interface RuntimeServices {
+  entrypoint: string
+  production: boolean
+  services: (RuntimeService | RuntimeServiceBase)[]
+}
+
+export interface MetricValue {
+  value: number
+  labels: {
+    route?: string
+    quantile?: number
+    method?: string
+    status_code?: number
+    telemetry_id?: string
+    type?: string
+    space?: string
+    version?: string
+    major?: number
+    minor?: number
+    patch?: number
+    le?: number | string
+    kind?: string
+    serviceId: string
+    workerId?: number
+    dispatcher_stats_url?: string
+  }
+  metricName?: string
+  exemplar?: unknown
+}
+
+export interface Metric {
+  help: string
+  name: string
+  type: string
+  values: MetricValue[]
+  aggregator: string
+}
+
+export interface LogIndexes {
+  pid: number
+  indexes: number[]
+}
+
+export class RuntimeApiClient {
+  getMatchingRuntime (options?: { pid?: string; name?: string }): Promise<Runtime>
+  getRuntimes (): Promise<Runtime[]>
+  getRuntimeMetadata (pid: number): Promise<Runtime>
+  getRuntimeServices (pid: number): Promise<RuntimeServices>
+  getRuntimeConfig (pid: number): Promise<Record<string, unknown>>
+  getRuntimeServiceConfig (pid: number, serviceId?: string): Promise<Record<string, unknown>>
+  getRuntimeEnv (pid: number): Promise<Record<string, string>>
+  getRuntimeOpenapi (pid: number, serviceId: string): Promise<Record<string, unknown>>
+  getRuntimeServiceEnv (pid: number, serviceId: string): Promise<Record<string, string>>
+  reloadRuntime (pid: number, options?: object): Promise<ChildProcess>
+  restartRuntime (pid: number): Promise<void>
+  stopRuntime (pid: number): Promise<void>
+  getRuntimeMetrics<T extends { format?: 'text' | 'json' }> (
+    pid: number,
+    options?: T
+  ): Promise<T extends { format: 'text' } ? string : Metric[]>
+  getRuntimeLiveMetricsStream (pid: number): WebSocketStream
+  getRuntimeLiveLogsStream (pid: number, startLogIndex?: number): WebSocketStream
+  getRuntimeLogsStream (pid: number, logsId: string, options?: { runtimePID?: number }): Promise<ReadableBody>
+  getRuntimeAllLogsStream (pid: number, options?: { runtimePID?: number }): Promise<ReadableBody>
+  getRuntimeLogIndexes (pid: number, options?: { all?: boolean }): Promise<LogIndexes[]>
+  injectRuntime (
+    pid: number,
+    serviceId: string,
+    options: {
+      url: string
+      method: string
+      headers?: Record<string, string>
+      query?: Record<string, any>
+      body?: any
+    }
+  ): Promise<Dispatcher.ResponseData>
+  close (): Promise<void>
+}

package/lib/{runtime-api-client.js → index.js}

@@ -1,19 +1,90 @@
-'use strict'
-
-const { tmpdir, platform, EOL } = require('node:os')
-const { join } = require('node:path')
-const { exec, spawn } = require('node:child_process')
-const { readdir, access } = require('node:fs/promises')
-const { Readable } = require('node:stream')
-const { Client } = require('undici')
-const WebSocket = require('ws')
-const errors = require('./errors.js')
-const { safeRemove } = require('@platformatic/utils')
+import { safeRemove } from '@platformatic/foundation'
+import { exec, spawn } from 'node:child_process'
+import { access, readdir } from 'node:fs/promises'
+import { EOL, platform, tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { Readable } from 'node:stream'
+import { Client } from 'undici'
+import WebSocket from 'ws'
+import {
+  FailedToGetRuntimeAllLogs,
+  FailedToGetRuntimeConfig,
+  FailedToGetRuntimeEnv,
+  FailedToGetRuntimeHistoryLogs,
+  FailedToGetRuntimeLogIndexes,
+  FailedToGetRuntimeMetadata,
+  FailedToGetRuntimeMetrics,
+  FailedToGetRuntimeOpenapi,
+  FailedToGetRuntimeServiceConfig,
+  FailedToGetRuntimeServiceEnv,
+  FailedToGetRuntimeServices,
+  FailedToReloadRuntime,
+  FailedToStopRuntime,
+  FailedToStreamRuntimeLogs,
+  RuntimeNotFound,
+  ServiceNotFound
+} from './errors.js'
 
 const PLATFORMATIC_TMP_DIR = join(tmpdir(), 'platformatic', 'runtimes')
 const PLATFORMATIC_PIPE_PREFIX = '\\\\.\\pipe\\platformatic-'
 
-class RuntimeApiClient {
+class WebSocketStream extends Readable {
+  constructor (url) {
+    super()
+    this.ws = new WebSocket(url)
+
+    this.ws.on('message', data => {
+      this.push(data)
+    })
+    this.ws.on('close', () => {
+      this.push(null)
+    })
+    this.ws.on('error', err => {
+      this.emit('error', new FailedToStreamRuntimeLogs(err.message))
+    })
+    this.on('close', () => {
+      this.ws.close()
+    })
+  }
+
+  _read () {}
+}
+
+export * from './errors.js'
+
+export async function getMatchingRuntime (client, positionals) {
+  const runtimes = await client.getRuntimes()
+  const pidOrName = positionals[0]
+  let runtime
+
+  // We have an argument to match
+  if (pidOrName) {
+    if (pidOrName.match(/^\d+$/)) {
+      const pid = parseInt(pidOrName)
+      runtime = runtimes.find(runtime => runtime.pid === pid)
+    } else {
+      runtime = runtimes.find(runtime => runtime.packageName === pidOrName)
+    }
+
+    if (runtime) {
+      return [runtime, positionals.slice(1)]
+    }
+  }
+
+  // We found no match, find any runtime whose running directory is the current one
+  if (!runtime) {
+    runtime = runtimes.find(runtime => runtime.cwd === process.cwd())
+  }
+
+  if (!runtime) {
+    throw RuntimeNotFound()
+  }
+  /* c8 ignore next 2 */
+
+  return [runtime, positionals]
+}
+
+export class RuntimeApiClient {
   #undiciClients = new Map()
   #webSockets = new Set()
 
@@ -29,15 +100,13 @@ class RuntimeApiClient {
       runtime = runtimes[0]
     }
     if (!runtime) {
-      throw errors.RuntimeNotFound()
+      throw new RuntimeNotFound()
     }
     return runtime
   }
 
   async getRuntimes () {
-    const runtimePIDs = platform() === 'win32'
-      ? await this.#getWindowsRuntimePIDs()
-      : await this.#getUnixRuntimePIDs()
+    const runtimePIDs = platform() === 'win32' ? await this.#getWindowsRuntimePIDs() : await this.#getUnixRuntimePIDs()
 
     const getMetadataRequests = await Promise.allSettled(
       runtimePIDs.map(async runtimePID => {
@@ -65,12 +134,12 @@ class RuntimeApiClient {
     const { statusCode, body } = await client.request({
       path: '/api/v1/metadata',
       method: 'GET',
-      headersTimeout: 10 * 1000,
+      headersTimeout: 10 * 1000
     })
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeMetadata(error)
+      throw new FailedToGetRuntimeMetadata(error)
     }
 
     const metadata = await body.json()
@@ -87,7 +156,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeServices(error)
+      throw new FailedToGetRuntimeServices(error)
     }
 
     const runtimeServices = await body.json()
@@ -104,7 +173,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeConfig(error)
+      throw new FailedToGetRuntimeConfig(error)
     }
 
     const runtimeConfig = await body.json()
@@ -128,11 +197,14 @@ class RuntimeApiClient {
         // No-op
       }
 
-      if (jsonError?.code === 'PLT_RUNTIME_SERVICE_NOT_FOUND' || jsonError?.code === 'PLT_RUNTIME_SERVICE_WORKER_NOT_FOUND') {
-        throw new errors.ServiceNotFound(error)
+      if (
+        jsonError?.code === 'PLT_RUNTIME_SERVICE_NOT_FOUND' ||
+        jsonError?.code === 'PLT_RUNTIME_SERVICE_WORKER_NOT_FOUND'
+      ) {
+        throw new ServiceNotFound(error)
       }
 
-      throw new errors.FailedToGetRuntimeServiceConfig(error)
+      throw new FailedToGetRuntimeServiceConfig(error)
     }
 
     const serviceConfig = await body.json()
@@ -149,7 +221,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeEnv(error)
+      throw new FailedToGetRuntimeEnv(error)
     }
 
     const runtimeEnv = await body.json()
@@ -166,7 +238,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeOpenapi(error)
+      throw new FailedToGetRuntimeOpenapi(error)
     }
 
     const openapi = await body.json()
@@ -190,11 +262,14 @@ class RuntimeApiClient {
         // No-op
       }
 
-      if (jsonError?.code === 'PLT_RUNTIME_SERVICE_NOT_FOUND' || jsonError?.code === 'PLT_RUNTIME_SERVICE_WORKER_NOT_FOUND') {
-        throw new errors.ServiceNotFound(error)
+      if (
+        jsonError?.code === 'PLT_RUNTIME_SERVICE_NOT_FOUND' ||
+        jsonError?.code === 'PLT_RUNTIME_SERVICE_WORKER_NOT_FOUND'
+      ) {
+        throw new ServiceNotFound(error)
       }
 
-      throw new errors.FailedToGetRuntimeServiceEnv(error)
+      throw new FailedToGetRuntimeServiceEnv(error)
     }
 
     const serviceConfig = await body.json()
@@ -228,7 +303,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToReloadRuntime(error)
+      throw new FailedToReloadRuntime(error)
     }
   }
 
@@ -242,7 +317,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToStopRuntime(error)
+      throw new FailedToStopRuntime(error)
     }
   }
 
@@ -266,12 +341,10 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeMetrics(error)
+      throw new FailedToGetRuntimeMetrics(error)
     }
 
-    const metrics = format === 'json'
-      ? await body.json()
-      : await body.text()
+    const metrics = format === 'json' ? await body.json() : await body.text()
 
     return metrics
   }
@@ -287,12 +360,12 @@ class RuntimeApiClient {
     return webSocketStream
   }
 
-  getRuntimeLiveLogsStream (pid, startLogIndex) {
+  getRuntimeLiveLogsStream (pid) {
     const socketPath = this.#getSocketPathFromPid(pid)
 
     const protocol = platform() === 'win32' ? 'ws+unix:' : 'ws+unix://'
-    const query = startLogIndex ? `?start=${startLogIndex}` : ''
-    const webSocketUrl = protocol + socketPath + ':/api/v1/logs/live' + query
+
+    const webSocketUrl = protocol + socketPath + ':/api/v1/logs/live'
     const webSocketStream = new WebSocketStream(webSocketUrl)
     this.#webSockets.add(webSocketStream.ws)
 
@@ -311,7 +384,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeHistoryLogs(error)
+      throw new FailedToGetRuntimeHistoryLogs(error)
     }
 
     return body
@@ -329,7 +402,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeAllLogs(error)
+      throw new FailedToGetRuntimeAllLogs(error)
     }
 
     return body
@@ -347,7 +420,7 @@ class RuntimeApiClient {
 
     if (statusCode !== 200) {
       const error = await body.text()
-      throw new errors.FailedToGetRuntimeLogIndexes(error)
+      throw new FailedToGetRuntimeLogIndexes(error)
     }
 
     const result = await body.json()
@@ -451,27 +524,3 @@ class RuntimeApiClient {
     await safeRemove(runtimeDir)
   }
 }
-
-class WebSocketStream extends Readable {
-  constructor (url) {
-    super()
-    this.ws = new WebSocket(url)
-
-    this.ws.on('message', data => {
-      this.push(data)
-    })
-    this.ws.on('close', () => {
-      this.push(null)
-    })
-    this.ws.on('error', err => {
-      this.emit('error', new errors.FailedToStreamRuntimeLogs(err.message))
-    })
-    this.on('close', () => {
-      this.ws.close()
-    })
-  }
-
-  _read () {}
-}
-
-module.exports = RuntimeApiClient

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@platformatic/control",
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.2",
   "description": "Platformatic Control",
-  "main": "index.js",
-  "bin": {
-    "plt-ctl": "./control.js"
-  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "type": "module",
   "author": "Platformatic Inc. <oss@platformatic.dev> (https://platformatic.dev)",
   "repository": {
     "type": "git",
@@ -24,22 +23,24 @@
     "split2": "^4.2.0",
     "tsd": "^0.32.0",
     "typescript": "^5.5.4",
-    "@platformatic/runtime": "3.0.0-alpha.1",
-    "@platformatic/service": "3.0.0-alpha.1"
+    "@platformatic/runtime": "3.0.0-alpha.2",
+    "@platformatic/service": "3.0.0-alpha.2"
   },
   "dependencies": {
     "@fastify/error": "^4.0.0",
-    "commist": "^3.2.0",
     "help-me": "^5.0.0",
-    "pino": "^9.0.0",
+    "pino": "^9.9.0",
     "pino-pretty": "^13.0.0",
     "table": "^6.8.1",
     "undici": "^7.0.0",
     "ws": "^8.16.0",
-    "@platformatic/utils": "3.0.0-alpha.1"
+    "@platformatic/foundation": "3.0.0-alpha.2"
+  },
+  "engines": {
+    "node": ">=22.18.0"
   },
   "scripts": {
-    "test": "pnpm run lint && pnpm run unit && tsd",
+    "test": "pnpm run lint && pnpm run unit && tsd --files test/index.test-d.ts",
     "unit": "borp --concurrency=1 --timeout=1200000",
     "lint": "eslint"
   }