@platformatic/node 2.72.0 → 3.0.0-alpha.1

package/config.d.ts

@@ -5,7 +5,7 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 
-export interface PlatformaticNodeJsStackable {
+export interface PlatformaticNodeJsConfig {
   $schema?: string;
   logger?: {
     level: (

package/index.js

@@ -1,435 +1,32 @@
-import {
-  BaseStackable,
-  cleanBasePath,
-  createServerListener,
-  ensureTrailingSlash,
-  getServerUrl,
-  importFile,
-  injectViaRequest,
-  schemaOptions,
-  transformConfig
-} from '@platformatic/basic'
-import { ConfigManager } from '@platformatic/config'
-import { features } from '@platformatic/utils'
-import inject from 'light-my-request'
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { Server } from 'node:http'
-import { resolve as pathResolve, resolve } from 'node:path'
-import { packageJson, schema } from './lib/schema.js'
-import { getTsconfig, ignoreDirs, isServiceBuildable } from './lib/utils.js'
+import { transform as basicTransform, resolve, validationOptions } from '@platformatic/basic'
+import { kMetadata, loadConfiguration as utilsLoadConfiguration } from '@platformatic/utils'
+import { schema } from './lib/schema.js'
+import { NodeStackable } from './lib/stackable.js'
 
-const validFields = [
-  'main',
-  'exports',
-  'exports',
-  'exports#node',
-  'exports#import',
-  'exports#require',
-  'exports#default',
-  'exports#.#node',
-  'exports#.#import',
-  'exports#.#require',
-  'exports#.#default'
-]
+export async function transform (config, _schema, options) {
+  config = await basicTransform(config, schema, options)
+  config.telemetry = { ...options.telemetryConfig, ...config.telemetry }
 
-const validFilesBasenames = ['index', 'main', 'app', 'application', 'server', 'start', 'bundle', 'run', 'entrypoint']
-
-// Paolo: This is kinda hackish but there is no better way. I apologize.
-function isFastify (app) {
-  return Object.getOwnPropertySymbols(app).some(s => s.description === 'fastify.state')
-}
-
-function isKoa (app) {
-  return typeof app.callback === 'function'
-}
-
-export class NodeStackable extends BaseStackable {
-  #module
-  #app
-  #server
-  #basePath
-  #dispatcher
-  #isFastify
-  #isKoa
-  #useHttpForDispatch
-
-  constructor (options, root, configManager) {
-    super('nodejs', packageJson.version, options, root, configManager)
-  }
-
-  async start ({ listen }) {
-    // Make this idempotent
-    if (this.url) {
-      return this.url
-    }
-
-    // Listen if entrypoint
-    if (this.#app && listen) {
-      await this._listen()
-      return this.url
-    }
-
-    const config = this.configManager.current
-
-    if (!this.isProduction && (await isServiceBuildable(this.root, config))) {
-      this.logger.info(`Building service "${this.serviceId}" before starting in devevelopment mode ...`)
-      try {
-        await this.build()
-        this.childManager = null
-      } catch (e) {
-        this.logger.error(`Error while building service "${this.serviceId}": ${e.message}`)
-      }
-    }
-
-    const command = config.application.commands[this.isProduction ? 'production' : 'development']
-
-    if (command) {
-      return this.startWithCommand(command)
-    }
-
-    // Resolve the entrypoint
-    // The priority is platformatic.application.json, then package.json and finally autodetect.
-    // Only when autodetecting we eventually search in the dist folder when in production mode
-    const finalEntrypoint = await this._findEntrypoint()
-
-    // Require the application
-    this.#basePath = config.application?.basePath
-      ? ensureTrailingSlash(cleanBasePath(config.application?.basePath))
-      : undefined
-
-    this.registerGlobals({
-      basePath: this.#basePath
-    })
-
-    // The server promise must be created before requiring the entrypoint even if it's not going to be used
-    // at all. Otherwise there is chance we miss the listen event.
-    const serverOptions = this.serverConfig
-    const serverPromise = createServerListener(
-      (this.isEntrypoint ? serverOptions?.port : undefined) ?? true,
-      (this.isEntrypoint ? serverOptions?.hostname : undefined) ?? true
-    )
-    this.#module = await importFile(finalEntrypoint)
-    this.#module = this.#module.default || this.#module
-
-    // Deal with application
-    const factory = ['build', 'create'].find(f => typeof this.#module[f] === 'function')
-
-    if (this.#module.hasServer !== false) {
-      if (factory) {
-        // We have build function, this Stackable will not use HTTP unless it is the entrypoint
-        serverPromise.cancel()
-
-        this.#app = await this.#module[factory]()
-        this.#isFastify = isFastify(this.#app)
-        this.#isKoa = isKoa(this.#app)
-
-        if (this.#isFastify) {
-          await this.#app.ready()
-        } else if (this.#isKoa) {
-          this.#dispatcher = this.#app.callback()
-        } else if (this.#app instanceof Server) {
-          this.#server = this.#app
-          this.#dispatcher = this.#server.listeners('request')[0]
-        }
-
-        if (listen) {
-          await this._listen()
-        }
-      } else {
-        // User blackbox function, we wait for it to listen on a port
-        this.#server = await serverPromise
-        this.#dispatcher = this.#server.listeners('request')[0]
-
-        this.url = getServerUrl(this.#server)
-      }
-    }
-
-    await this._collectMetrics()
-    return this.url
-  }
-
-  async stop () {
-    if (this.childManager) {
-      return this.stopCommand()
-    }
-
-    if (this.#isFastify) {
-      return this.#app.close()
-    }
-
-    /* c8 ignore next 3 */
-    if (!this.#server?.listening) {
-      return
-    }
-
-    return new Promise((resolve, reject) => {
-      this.#server.close(error => {
-        /* c8 ignore next 3 */
-        if (error) {
-          return reject(error)
-        }
-
-        resolve()
-      })
-    })
-  }
-
-  async build () {
-    const config = this.configManager.current
-    const disableChildManager = config.node?.disablePlatformaticInBuild
-    const command = config.application?.commands?.build
-
-    if (command) {
-      return this.buildWithCommand(command, null, { disableChildManager })
-    }
-
-    // If no command was specified, we try to see if there is a build script defined in package.json.
-    const hasBuildScript = await this.#hasBuildScript()
-
-    if (!hasBuildScript) {
-      this.logger.debug(
-        'No "application.commands.build" configuration value specified and no build script found in package.json. Skipping build ...'
-      )
-      return
-    }
-
-    return this.buildWithCommand('npm run build', null, { disableChildManager })
-  }
-
-  async inject (injectParams, onInject) {
-    let res
-
-    if (this.#useHttpForDispatch) {
-      this.logger.trace({ injectParams, url: this.url }, 'injecting via request')
-      res = await injectViaRequest(this.url, injectParams, onInject)
-    } else {
-      if (this.#isFastify) {
-        this.logger.trace({ injectParams }, 'injecting via fastify')
-        res = await this.#app.inject(injectParams, onInject)
-      } else {
-        this.logger.trace({ injectParams }, 'injecting via light-my-request')
-        res = await inject(this.#dispatcher ?? this.#app, injectParams, onInject)
-      }
-    }
-
-    /* c8 ignore next 3 */
-    if (onInject) {
-      return
-    }
-
-    // Since inject might be called from the main thread directly via ITC, let's clean it up
-    const { statusCode, headers, body, payload, rawPayload } = res
-
-    return { statusCode, headers, body, payload, rawPayload }
-  }
-
-  _getWantsAbsoluteUrls () {
-    const config = this.configManager.current
-    return config.node.absoluteUrl
-  }
-
-  getMeta () {
-    return {
-      composer: {
-        tcp: typeof this.url !== 'undefined',
-        url: this.url,
-        prefix: this.basePath ?? this.#basePath,
-        wantsAbsoluteUrls: this._getWantsAbsoluteUrls(),
-        needsRootTrailingSlash: true
-      },
-      connectionStrings: this.connectionString ? [this.connectionString] : []
-    }
-  }
-
-  async getDispatchTarget () {
-    this.#useHttpForDispatch =
-      this.childManager || (this.url && this.configManager.current.node?.dispatchViaHttp === true)
-
-    if (this.#useHttpForDispatch) {
-      return this.getUrl()
-    }
-
-    return this.getDispatchFunc()
-  }
-
-  async _listen () {
-    const serverOptions = this.serverConfig
-    const listenOptions = { host: serverOptions?.hostname || '127.0.0.1', port: serverOptions?.port || 0 }
-
-    if (this.isProduction && features.node.reusePort) {
-      listenOptions.reusePort = true
-    }
-
-    if (this.#isFastify) {
-      await this.#app.listen(listenOptions)
-      this.url = getServerUrl(this.#app.server)
-    } else {
-      // Express / Node / Koa
-      this.#server = await new Promise((resolve, reject) => {
-        return this.#app
-          .listen(listenOptions, function () {
-            resolve(this)
-          })
-          .on('error', reject)
-      })
-
-      this.url = getServerUrl(this.#server)
-    }
-
-    return this.url
-  }
-
-  _getApplication () {
-    return this.#app
-  }
-
-  async _findEntrypoint () {
-    const config = this.configManager.current
-
-    if (config.node.main) {
-      return pathResolve(this.root, config.node.main)
-    }
-
-    const { entrypoint, hadEntrypointField } = await getEntrypointInformation(this.root)
-
-    if (typeof this.workerId === 'undefined' || this.workerId === 0) {
-      if (!entrypoint) {
-        this.logger.error(
-          `The service "${this.serviceId}" had no valid entrypoint defined in the package.json file and no valid entrypoint file was found.`
-        )
-
-        process.exit(1)
-      }
-
-      if (!hadEntrypointField) {
-        this.logger.warn(
-          `The service "${this.serviceId}" had no valid entrypoint defined in the package.json file. Falling back to the file "${entrypoint}".`
-        )
-      }
-    }
-
-    return pathResolve(this.root, entrypoint)
-  }
-
-  async #hasBuildScript () {
-    // If no command was specified, we try to see if there is a build script defined in package.json.
-    let hasBuildScript
-    try {
-      const packageJson = JSON.parse(await readFile(resolve(this.root, 'package.json'), 'utf-8'))
-      hasBuildScript = typeof packageJson.scripts.build === 'string' && packageJson.scripts.build
-    } catch (e) {
-      // No-op
-    }
-
-    return hasBuildScript
-  }
-
-  async getWatchConfig () {
-    const config = this.configManager.current
-
-    const enabled = config.watch?.enabled !== false
-
-    if (!enabled) {
-      return { enabled, path: this.root }
-    }
-
-    // ignore the outDir from tsconfig or service config if any
-    let ignore = config.watch?.ignore
-    if (!ignore) {
-      const tsConfig = await getTsconfig(this.root, config)
-      if (tsConfig) {
-        ignore = ignoreDirs(tsConfig?.compilerOptions?.outDir, tsConfig?.watchOptions?.excludeDirectories)
-      }
-    }
-
-    return {
-      enabled,
-      path: this.root,
-      allow: config.watch?.allow,
-      ignore
-    }
-  }
+  return config
 }
 
-async function getEntrypointInformation (root) {
-  let entrypoint
-  let packageJson
-  let hadEntrypointField = false
-
-  try {
-    packageJson = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf-8'))
-  } catch {
-    // No package.json, we only load the index.js file
-    packageJson = {}
-  }
-
-  for (const field of validFields) {
-    let current = packageJson
-    const sequence = field.split('#')
-
-    while (current && sequence.length && typeof current !== 'string') {
-      current = current[sequence.shift()]
-    }
-
-    if (typeof current === 'string') {
-      entrypoint = current
-      hadEntrypointField = true
-      break
-    }
-  }
+export async function loadConfiguration (configOrRoot, sourceOrConfig, context) {
+  const { root, source } = await resolve(configOrRoot, sourceOrConfig, 'application')
 
-  if (!entrypoint) {
-    for (const basename of validFilesBasenames) {
-      for (const ext of ['js', 'mjs', 'cjs']) {
-        const file = `${basename}.${ext}`
-
-        if (existsSync(resolve(root, file))) {
-          entrypoint = file
-          break
-        }
-      }
-
-      if (entrypoint) {
-        break
-      }
-    }
-  }
-
-  return { entrypoint, hadEntrypointField }
-}
-
-export async function buildStackable (opts) {
-  const root = opts.context.directory
-
-  const configManager = new ConfigManager({
-    schema,
-    source: opts.config ?? {},
-    schemaOptions,
-    transformConfig,
-    dirname: root,
-    context: opts.context
+  return utilsLoadConfiguration(source, context?.schema ?? schema, {
+    validationOptions,
+    transform,
+    replaceEnv: true,
+    root,
+    ...context
   })
-  await configManager.parseAndValidate()
-  const config = configManager.current
-  // We need to update the config with the telemetry so the service name
-  // used in telemetry can be retreived using the management API
-  config.telemetry = opts.context.telemetryConfig
-  configManager.update(config)
+}
 
-  return new NodeStackable(opts, root, configManager)
+export async function create (configOrRoot, sourceOrConfig, context) {
+  const config = await loadConfiguration(configOrRoot, sourceOrConfig, context)
+  return new NodeStackable(config[kMetadata].root, config, context)
 }
 
 export { Generator } from './lib/generator.js'
-export { schema, schemaComponents } from './lib/schema.js'
-
-export default {
-  configType: 'nodejs',
-  configManagerConfig: {
-    schemaOptions,
-    transformConfig
-  },
-  buildStackable,
-  schema,
-  version: packageJson.version
-}
+export { packageJson, schema, schemaComponents, version } from './lib/schema.js'
+export * from './lib/stackable.js'

package/lib/schema.js

@@ -1,9 +1,9 @@
 import { schemaComponents as basicSchemaComponents } from '@platformatic/basic'
 import { schemaComponents as utilsSchemaComponents } from '@platformatic/utils'
 import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
 
-export const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'))
-
+export const packageJson = JSON.parse(readFileSync(resolve(import.meta.dirname, '../package.json'), 'utf8'))
 export const version = packageJson.version
 
 const node = {
@@ -35,7 +35,7 @@ export const schemaComponents = { node }
 export const schema = {
   $id: `https://schemas.platformatic.dev/@platformatic/node/${version}.json`,
   $schema: 'http://json-schema.org/draft-07/schema#',
-  title: 'Platformatic Node.js Stackable',
+  title: 'Platformatic Node.js Config',
   type: 'object',
   properties: {
     $schema: {

package/lib/stackable.js

@@ -0,0 +1,396 @@
+import {
+  BaseStackable,
+  cleanBasePath,
+  createServerListener,
+  ensureTrailingSlash,
+  getServerUrl,
+  importFile,
+  injectViaRequest
+} from '@platformatic/basic'
+import { features } from '@platformatic/utils'
+import inject from 'light-my-request'
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { Server } from 'node:http'
+import { resolve as resolvePath } from 'node:path'
+import { version } from './schema.js'
+import { getTsconfig, ignoreDirs, isServiceBuildable } from './utils.js'
+
+const validFields = [
+  'main',
+  'exports',
+  'exports',
+  'exports#node',
+  'exports#import',
+  'exports#require',
+  'exports#default',
+  'exports#.#node',
+  'exports#.#import',
+  'exports#.#require',
+  'exports#.#default'
+]
+
+const validFilesBasenames = ['index', 'main', 'app', 'application', 'server', 'start', 'bundle', 'run', 'entrypoint']
+
+// Paolo: This is kinda hackish but there is no better way. I apologize.
+function isFastify (app) {
+  return Object.getOwnPropertySymbols(app).some(s => s.description === 'fastify.state')
+}
+
+function isKoa (app) {
+  return typeof app.callback === 'function'
+}
+
+async function getEntrypointInformation (root) {
+  let entrypoint
+  let packageJson
+  let hadEntrypointField = false
+
+  try {
+    packageJson = JSON.parse(await readFile(resolvePath(root, 'package.json'), 'utf-8'))
+  } catch {
+    // No package.json, we only load the index.js file
+    packageJson = {}
+  }
+
+  for (const field of validFields) {
+    let current = packageJson
+    const sequence = field.split('#')
+
+    while (current && sequence.length && typeof current !== 'string') {
+      current = current[sequence.shift()]
+    }
+
+    if (typeof current === 'string') {
+      entrypoint = current
+      hadEntrypointField = true
+      break
+    }
+  }
+
+  if (!entrypoint) {
+    for (const basename of validFilesBasenames) {
+      for (const ext of ['js', 'mjs', 'cjs']) {
+        const file = `${basename}.${ext}`
+
+        if (existsSync(resolvePath(root, file))) {
+          entrypoint = file
+          break
+        }
+      }
+
+      if (entrypoint) {
+        break
+      }
+    }
+  }
+
+  return { entrypoint, hadEntrypointField }
+}
+
+export class NodeStackable extends BaseStackable {
+  #module
+  #app
+  #server
+  #basePath
+  #dispatcher
+  #isFastify
+  #isKoa
+  #useHttpForDispatch
+
+  constructor (root, config, context) {
+    super('nodejs', version, root, config, context)
+  }
+
+  async start ({ listen }) {
+    // Make this idempotent
+    if (this.url) {
+      return this.url
+    }
+
+    // Listen if entrypoint
+    if (this.#app && listen) {
+      await this._listen()
+      return this.url
+    }
+
+    const config = this.config
+
+    if (!this.isProduction && (await isServiceBuildable(this.root, config))) {
+      this.logger.info(`Building service "${this.serviceId}" before starting in devevelopment mode ...`)
+      try {
+        await this.build()
+        this.childManager = null
+      } catch (e) {
+        this.logger.error(`Error while building service "${this.serviceId}": ${e.message}`)
+      }
+    }
+
+    const command = config.application.commands[this.isProduction ? 'production' : 'development']
+
+    if (command) {
+      return this.startWithCommand(command)
+    }
+
+    // Resolve the entrypoint
+    // The priority is platformatic.application.json, then package.json and finally autodetect.
+    // Only when autodetecting we eventually search in the dist folder when in production mode
+    const finalEntrypoint = await this._findEntrypoint()
+
+    // Require the application
+    this.#basePath = config.application?.basePath
+      ? ensureTrailingSlash(cleanBasePath(config.application?.basePath))
+      : undefined
+
+    this.registerGlobals({
+      basePath: this.#basePath
+    })
+
+    // The server promise must be created before requiring the entrypoint even if it's not going to be used
+    // at all. Otherwise there is chance we miss the listen event.
+    const serverOptions = this.serverConfig
+    const serverPromise = createServerListener(
+      (this.isEntrypoint ? serverOptions?.port : undefined) ?? true,
+      (this.isEntrypoint ? serverOptions?.hostname : undefined) ?? true
+    )
+    this.#module = await importFile(finalEntrypoint)
+    this.#module = this.#module.default || this.#module
+
+    // Deal with application
+    const factory = ['build', 'create'].find(f => typeof this.#module[f] === 'function')
+
+    if (this.#module.hasServer !== false) {
+      if (factory) {
+        // We have build function, this Stackable will not use HTTP unless it is the entrypoint
+        serverPromise.cancel()
+
+        this.#app = await this.#module[factory]()
+        this.#isFastify = isFastify(this.#app)
+        this.#isKoa = isKoa(this.#app)
+
+        if (this.#isFastify) {
+          await this.#app.ready()
+        } else if (this.#isKoa) {
+          this.#dispatcher = this.#app.callback()
+        } else if (this.#app instanceof Server) {
+          this.#server = this.#app
+          this.#dispatcher = this.#server.listeners('request')[0]
+        }
+
+        if (listen) {
+          await this._listen()
+        }
+      } else {
+        // User blackbox function, we wait for it to listen on a port
+        this.#server = await serverPromise
+        this.#dispatcher = this.#server.listeners('request')[0]
+
+        this.url = getServerUrl(this.#server)
+      }
+    }
+
+    await this._collectMetrics()
+    return this.url
+  }
+
+  async stop () {
+    if (this.childManager) {
+      return this.stopCommand()
+    }
+
+    if (this.#isFastify) {
+      return this.#app.close()
+    }
+
+    /* c8 ignore next 3 */
+    if (!this.#server?.listening) {
+      return
+    }
+
+    return new Promise((resolve, reject) => {
+      this.#server.close(error => {
+        /* c8 ignore next 3 */
+        if (error) {
+          return reject(error)
+        }
+
+        resolve()
+      })
+    })
+  }
+
+  async build () {
+    const config = this.config
+    const disableChildManager = config.node?.disablePlatformaticInBuild
+    const command = config.application?.commands?.build
+
+    if (command) {
+      return this.buildWithCommand(command, null, { disableChildManager })
+    }
+
+    // If no command was specified, we try to see if there is a build script defined in package.json.
+    const hasBuildScript = await this.#hasBuildScript()
+
+    if (!hasBuildScript) {
+      this.logger.debug(
+        'No "application.commands.build" configuration value specified and no build script found in package.json. Skipping build ...'
+      )
+      return
+    }
+
+    return this.buildWithCommand('npm run build', null, { disableChildManager })
+  }
+
+  async inject (injectParams, onInject) {
+    let res
+
+    if (this.#useHttpForDispatch) {
+      this.logger.trace({ injectParams, url: this.url }, 'injecting via request')
+      res = await injectViaRequest(this.url, injectParams, onInject)
+    } else {
+      if (this.#isFastify) {
+        this.logger.trace({ injectParams }, 'injecting via fastify')
+        res = await this.#app.inject(injectParams, onInject)
+      } else {
+        this.logger.trace({ injectParams }, 'injecting via light-my-request')
+        res = await inject(this.#dispatcher ?? this.#app, injectParams, onInject)
+      }
+    }
+
+    /* c8 ignore next 3 */
+    if (onInject) {
+      return
+    }
+
+    // Since inject might be called from the main thread directly via ITC, let's clean it up
+    const { statusCode, headers, body, payload, rawPayload } = res
+
+    return { statusCode, headers, body, payload, rawPayload }
+  }
+
+  _getWantsAbsoluteUrls () {
+    const config = this.config
+    return config.node.absoluteUrl
+  }
+
+  getMeta () {
+    return {
+      composer: {
+        tcp: typeof this.url !== 'undefined',
+        url: this.url,
+        prefix: this.basePath ?? this.#basePath,
+        wantsAbsoluteUrls: this._getWantsAbsoluteUrls(),
+        needsRootTrailingSlash: true
+      },
+      connectionStrings: this.connectionString ? [this.connectionString] : []
+    }
+  }
+
+  async getDispatchTarget () {
+    this.#useHttpForDispatch = this.childManager || (this.url && this.config.node?.dispatchViaHttp === true)
+
+    if (this.#useHttpForDispatch) {
+      return this.getUrl()
+    }
+
+    return this.getDispatchFunc()
+  }
+
+  async _listen () {
+    const serverOptions = this.serverConfig
+    const listenOptions = { host: serverOptions?.hostname || '127.0.0.1', port: serverOptions?.port || 0 }
+
+    if (this.isProduction && features.node.reusePort) {
+      listenOptions.reusePort = true
+    }
+
+    if (this.#isFastify) {
+      await this.#app.listen(listenOptions)
+      this.url = getServerUrl(this.#app.server)
+    } else {
+      // Express / Node / Koa
+      this.#server = await new Promise((resolve, reject) => {
+        return this.#app
+          .listen(listenOptions, function () {
+            resolve(this)
+          })
+          .on('error', reject)
+      })
+
+      this.url = getServerUrl(this.#server)
+    }
+
+    return this.url
+  }
+
+  _getApplication () {
+    return this.#app
+  }
+
+  async _findEntrypoint () {
+    const config = this.config
+
+    if (config.node.main) {
+      return resolvePath(this.root, config.node.main)
+    }
+
+    const { entrypoint, hadEntrypointField } = await getEntrypointInformation(this.root)
+
+    if (typeof this.workerId === 'undefined' || this.workerId === 0) {
+      if (!entrypoint) {
+        this.logger.error(
+          `The service "${this.serviceId}" had no valid entrypoint defined in the package.json file and no valid entrypoint file was found.`
+        )
+
+        process.exit(1)
+      }
+
+      if (!hadEntrypointField) {
+        this.logger.warn(
+          `The service "${this.serviceId}" had no valid entrypoint defined in the package.json file. Falling back to the file "${entrypoint}".`
+        )
+      }
+    }
+
+    return resolvePath(this.root, entrypoint)
+  }
+
+  async #hasBuildScript () {
+    // If no command was specified, we try to see if there is a build script defined in package.json.
+    let hasBuildScript
+    try {
+      const packageJson = JSON.parse(await readFile(resolvePath(this.root, 'package.json'), 'utf-8'))
+      hasBuildScript = typeof packageJson.scripts.build === 'string' && packageJson.scripts.build
+    } catch (e) {
+      // No-op
+    }
+
+    return hasBuildScript
+  }
+
+  async getWatchConfig () {
+    const config = this.config
+
+    const enabled = config.watch?.enabled !== false
+
+    if (!enabled) {
+      return { enabled, path: this.root }
+    }
+
+    // ignore the outDir from tsconfig or service config if any
+    let ignore = config.watch?.ignore
+    if (!ignore) {
+      const tsConfig = await getTsconfig(this.root, config)
+      if (tsConfig) {
+        ignore = ignoreDirs(tsConfig?.compilerOptions?.outDir, tsConfig?.watchOptions?.excludeDirectories)
+      }
+    }
+
+    return {
+      enabled,
+      path: this.root,
+      allow: config.watch?.allow,
+      ignore
+    }
+  }
+}

package/lib/utils.js

@@ -1,6 +1,6 @@
-import path, { join } from 'node:path'
-import { readFile } from 'node:fs/promises'
 import json5 from 'json5'
+import { readFile } from 'node:fs/promises'
+import path, { join } from 'node:path'
 
 export async function isServiceBuildable (serviceRoot, config) {
   // skip vite as stackable as it has its own build command
@@ -56,12 +56,13 @@ export function ignoreDirs (outDir, watchOptionsExcludeDirectories) {
   if (outDir) {
     ignore.add(outDir)
     if (!outDir.endsWith('/**')) {
-      ignore.add(`${outDir}/**`)
+      ignore.add(`${outDir}/*`)
+      ignore.add(`${outDir}/**/*`)
     }
   }
 
   if (ignore.size === 0) {
-    return ['dist', 'dist/**']
+    return ['dist', 'dist/*', 'dist/**/*']
   }
 
   return Array.from(ignore)

package/package.json

@@ -1,13 +1,9 @@
 {
   "name": "@platformatic/node",
-  "version": "2.72.0",
+  "version": "3.0.0-alpha.1",
   "description": "Platformatic Node.js Stackable",
   "main": "index.js",
   "type": "module",
-  "bin": {
-    "create-platformatic-node": "./bin/create.js",
-    "start-platformatic-node": "./bin/start.js"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/platformatic/platformatic.git"
@@ -21,10 +17,9 @@
   "dependencies": {
     "json5": "^2.2.3",
     "light-my-request": "^6.0.0",
-    "@platformatic/config": "2.72.0",
-    "@platformatic/basic": "2.72.0",
-    "@platformatic/generators": "2.72.0",
-    "@platformatic/utils": "2.72.0"
+    "@platformatic/basic": "3.0.0-alpha.1",
+    "@platformatic/generators": "3.0.0-alpha.1",
+    "@platformatic/utils": "3.0.0-alpha.1"
   },
   "devDependencies": {
     "borp": "^0.20.0",
@@ -36,12 +31,12 @@
     "neostandard": "^0.12.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.4",
-    "@platformatic/composer": "2.72.0",
-    "@platformatic/service": "2.72.0"
+    "@platformatic/composer": "3.0.0-alpha.1",
+    "@platformatic/service": "3.0.0-alpha.1"
   },
   "scripts": {
-    "test": "pnpm run lint && borp --concurrency=1 --no-timeout",
-    "coverage": "pnpm run lint && borp -C -X test -X test/fixtures --concurrency=1 --no-timeout",
+    "test": "pnpm run lint && borp --concurrency=1 --timeout 1200000",
+    "coverage": "pnpm run lint && borp -C -X test -X test/fixtures --concurrency=1 --timeout 1200000",
     "gen-schema": "node lib/schema.js > schema.json",
     "gen-types": "json2ts > config.d.ts < schema.json",
     "build": "pnpm run gen-schema && pnpm run gen-types",

package/schema.json

@@ -1,7 +1,7 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/node/2.72.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/node/3.0.0-alpha.1.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Platformatic Node.js Stackable",
+  "title": "Platformatic Node.js Config",
   "type": "object",
   "properties": {
     "$schema": {

package/bin/create.js

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-
-import { basename, join } from 'node:path'
-import { parseArgs } from 'node:util'
-import { Generator } from '../lib/generator.js'
-
-async function execute () {
-  const args = parseArgs({
-    args: process.argv.slice(2),
-    options: {
-      dir: {
-        type: 'string',
-        default: join(process.cwd(), 'plt-node')
-      },
-      main: { type: 'string', default: 'index.js' }
-    }
-  })
-
-  const generator = new Generator()
-
-  generator.setConfig({
-    targetDirectory: args.values.dir,
-    serviceName: basename(args.values.dir),
-    main: args.values.main
-  })
-
-  await generator.run()
-
-  console.log('Application created successfully! Run `npm run start` to start an application.')
-}
-
-execute()

package/bin/start.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-
-import { findConfigurationFile, loadConfigurationFile } from '@platformatic/config'
-import { ensureLoggableError } from '@platformatic/utils'
-import { buildStackable } from '../index.js'
-
-async function execute () {
-  const root = process.cwd()
-  const configurationFile = await findConfigurationFile(root)
-
-  const stackable = await buildStackable({
-    config: await loadConfigurationFile(configurationFile),
-    context: {
-      directory: process.cwd(),
-      serverConfig: configurationFile?.runtime?.server ?? {},
-      isEntrypoint: true,
-      isProduction: true,
-      runtimeConfig: {
-        logger: {
-          level: 'info',
-          pretty: true
-        }
-      }
-    }
-  })
-
-  try {
-    // Set the location of the config
-    const url = await stackable.start({ listen: true })
-    stackable.logger.info('Server listening on %s', url)
-  } catch (error) {
-    stackable.logger.error({ error: ensureLoggableError(error) }, 'Error starting the application.')
-  }
-}
-
-execute()