@platformatic/nuxt 0.0.1 → 3.58.1

package/test/fixtures/ssr-with-prefix/platformatic.runtime.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/runtime/2.0.0.json",
+  "entrypoint": "composer",
+  "services": [
+    {
+      "id": "frontend",
+      "config": "platformatic.application.json",
+      "path": "./services/frontend"
+    },
+    {
+      "id": "backend",
+      "config": "platformatic.json",
+      "path": "./services/backend"
+    },
+    {
+      "id": "composer",
+      "config": "platformatic.json",
+      "path": "./services/composer"
+    }
+  ],
+  "logger": {
+    "level": "error"
+  }
+}

package/test/fixtures/ssr-with-prefix/services/frontend/app.vue

@@ -0,0 +1,8 @@
+<template>
+  <div>Hello from v{{ version }} t{{ time }}</div>
+</template>
+
+<script setup>
+const version = 123
+const time = Date.now()
+</script>

package/test/fixtures/ssr-with-prefix/services/frontend/nuxt.config.js

@@ -0,0 +1,15 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+  app: {
+    baseURL: '/frontend/'
+  },
+  compatibilityDate: '2026-06-15',
+  telemetry: false,
+  devtools: { enabled: false },
+  vite: {
+    server: {
+      allowedHosts: ['.plt.local']
+    }
+  }
+})

package/test/fixtures/ssr-with-prefix/services/frontend/package.json

@@ -0,0 +1,9 @@
+{
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@platformatic/nuxt": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/ssr-with-prefix/services/frontend/platformatic.application.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/nuxt/3.52.4.json",
+  "application": {
+    "basePath": "/frontend"
+  }
+}

package/test/fixtures/ssr-without-prefix/package.json

@@ -0,0 +1,10 @@
+{
+  "private": true,
+  "dependencies": {
+    "@platformatic/gateway": "^3.52.4",
+    "@platformatic/nuxt": "^3.52.4",
+    "@platformatic/service": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/ssr-without-prefix/platformatic.runtime.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/runtime/2.0.0.json",
+  "entrypoint": "composer",
+  "services": [
+    {
+      "id": "frontend",
+      "config": "platformatic.application.json",
+      "path": "./services/frontend"
+    },
+    {
+      "id": "backend",
+      "config": "platformatic.json",
+      "path": "./services/backend"
+    },
+    {
+      "id": "composer",
+      "config": "platformatic.json",
+      "path": "./services/composer"
+    }
+  ],
+  "logger": {
+    "level": "error"
+  }
+}

package/test/fixtures/ssr-without-prefix/services/frontend/app.vue

@@ -0,0 +1,8 @@
+<template>
+  <div>Hello from v{{ version }} t{{ time }}</div>
+</template>
+
+<script setup>
+const version = 123
+const time = Date.now()
+</script>

package/test/fixtures/ssr-without-prefix/services/frontend/nuxt.config.js

@@ -0,0 +1,12 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+  compatibilityDate: '2026-06-15',
+  telemetry: false,
+  devtools: { enabled: false },
+  vite: {
+    server: {
+      allowedHosts: ['.plt.local']
+    }
+  }
+})

package/test/fixtures/ssr-without-prefix/services/frontend/package.json

@@ -0,0 +1,9 @@
+{
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@platformatic/nuxt": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/ssr-without-prefix/services/frontend/platformatic.application.json

@@ -0,0 +1,3 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/nuxt/3.52.4.json"
+}

package/test/fixtures/standalone/package.json

@@ -0,0 +1,8 @@
+{
+  "private": true,
+  "dependencies": {
+    "@platformatic/nuxt": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/standalone/platformatic.runtime.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/runtime/2.0.0.json",
+  "entrypoint": "frontend",
+  "services": [
+    {
+      "id": "frontend",
+      "config": "platformatic.application.json",
+      "path": "./services/frontend"
+    }
+  ],
+  "logger": {
+    "level": "info"
+  },
+  "restartOnError": false
+}

package/test/fixtures/standalone/services/frontend/app.vue

@@ -0,0 +1,8 @@
+<template>
+  <div>Hello from v{{ version }} t{{ time }}</div>
+</template>
+
+<script setup>
+const version = 123
+const time = Date.now()
+</script>

package/test/fixtures/standalone/services/frontend/nuxt.config.js

@@ -0,0 +1,13 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+  ssr: false,
+  compatibilityDate: '2026-06-15',
+  telemetry: false,
+  devtools: { enabled: false },
+  vite: {
+    server: {
+      allowedHosts: ['.plt.local']
+    }
+  }
+})

package/test/fixtures/standalone/services/frontend/package.json

@@ -0,0 +1,9 @@
+{
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@platformatic/nuxt": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/standalone/services/frontend/platformatic.application.json

@@ -0,0 +1,3 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/nuxt/3.52.4.json"
+}

package/test/helper.js

@@ -0,0 +1 @@
+export const additionalDependencies = ['nuxt', 'vue', 'vite']

package/test/https.test.js

@@ -0,0 +1,43 @@
+import { ok } from 'node:assert'
+import { resolve } from 'node:path'
+import { test } from 'node:test'
+import {
+  buildRuntime,
+  configureHTTPS,
+  createHTTPSDispatcher,
+  prepareRuntime,
+  setAdditionalDependencies,
+  setFixturesDir,
+  startRuntime,
+  verifyHTMLViaHTTPS
+} from '../../basic/test/helper.js'
+import { additionalDependencies } from './helper.js'
+
+setFixturesDir(resolve(import.meta.dirname, './fixtures'))
+setAdditionalDependencies(additionalDependencies)
+
+async function startHTTPSRuntime (t, production) {
+  const { runtime, root } = await prepareRuntime(t, 'standalone', production, null, configureHTTPS)
+
+  if (production) {
+    await buildRuntime(root)
+  }
+
+  const url = await startRuntime(t, runtime)
+  ok(url.startsWith('https://'))
+  return url
+}
+
+test('supports https server options in development mode', async t => {
+  const dispatcher = createHTTPSDispatcher(t)
+  const url = await startHTTPSRuntime(t, false)
+
+  await verifyHTMLViaHTTPS(url, '/', ['<script>window.__NUXT__={}'], dispatcher)
+})
+
+test('supports https server options in production mode', async t => {
+  const dispatcher = createHTTPSDispatcher(t)
+  const url = await startHTTPSRuntime(t, true)
+
+  await verifyHTMLViaHTTPS(url, '/', ['<script>window.__NUXT__={}'], dispatcher)
+})

package/test/logger.test.js

@@ -0,0 +1,31 @@
+import { strict as assert } from 'node:assert'
+import path from 'node:path'
+import { test } from 'node:test'
+import { request } from 'undici'
+import { createRuntime, getLogsFromFile } from '../../basic/test/helper.js'
+
+test('logger options', async t => {
+  const { url, root, runtime } = await createRuntime({
+    t,
+    root: path.resolve(import.meta.dirname, './fixtures/logger'),
+    build: true,
+    production: true
+  })
+
+  await request(`${url}/`, { headers: { Authorization: 'token' } })
+  await runtime.close()
+
+  const logs = await getLogsFromFile(root)
+
+  assert.ok(
+    logs.find(log => {
+      return (
+        log.stdout &&
+        log.stdout.name === 'nuxt' &&
+        log.stdout.level === 'INFO' &&
+        log.stdout.time.length === 24 &&
+        log.stdout.msg === 'Log from Nuxt App page'
+      )
+    })
+  )
+})

package/test/metrics.test.js

@@ -0,0 +1,46 @@
+import assert from 'node:assert'
+import path from 'node:path'
+import { test } from 'node:test'
+import { request } from 'undici'
+import { createRuntime } from '../../basic/test/helper.js'
+import { assertMetric, expectedMetrics } from '../../metrics/test/helper.js'
+
+const envs = {
+  production: {
+    build: true,
+    production: true
+  },
+  dev: {
+    build: false,
+    production: false
+  }
+}
+
+for (const [env, options] of Object.entries(envs)) {
+  test(`Nuxt application properly collects metrics ${env}`, async t => {
+    const { url } = await createRuntime({
+      t,
+      root: path.resolve(import.meta.dirname, './fixtures/metrics'),
+      build: options.build,
+      production: options.production
+    })
+
+    {
+      const res = await request(`${url}/`)
+      const body = await res.body.text()
+
+      assert.ok(body.length > 0)
+      assert.strictEqual(res.statusCode, 200)
+    }
+
+    {
+      const hostname = new URL(url).hostname
+      const res = await request(`http://${hostname}:9090/metrics`)
+      const metrics = await res.body.text()
+
+      for (const metric of expectedMetrics) {
+        assertMetric(metrics, metric)
+      }
+    }
+  })
+}

package/test/miscellaneous.test.js

@@ -0,0 +1,33 @@
+import { deepStrictEqual, ok } from 'node:assert'
+import path from 'node:path'
+import { test } from 'node:test'
+import { request } from 'undici'
+import { createRuntime, getLogsFromFile } from '../../basic/test/helper.js'
+
+test('should not show start in handle mode in production', async t => {
+  const { url, root, runtime } = await createRuntime({
+    t,
+    root: path.resolve(import.meta.dirname, './fixtures/standalone'),
+    build: true,
+    production: true
+  })
+
+  {
+    const { statusCode } = await request(url + '/')
+    deepStrictEqual(statusCode, 200)
+    await runtime.close()
+  }
+
+  const logs = await getLogsFromFile(root)
+
+  ok(
+    !logs.find(
+      entry =>
+        entry.level === 40 &&
+        entry.name === 'frontend' &&
+        entry.msg.startsWith(
+          'A listener has been added for the "process.uncaughtException" event. This listener will be never triggered as Watt default behavior will kill the process before.'
+        )
+    )
+  )
+})

package/test/production.test.js

@@ -0,0 +1,153 @@
+import { resolve } from 'node:path'
+import {
+  internalApplicationsFiles,
+  setAdditionalDependencies,
+  setFixturesDir,
+  verifyBuildAndProductionMode,
+  verifyFrontendOnAutodetectedPrefix,
+  verifyFrontendOnPrefix,
+  verifyFrontendOnRoot,
+  verifyHTMLViaHTTP,
+  verifyPlatformaticGateway,
+  verifyPlatformaticService,
+} from '../../basic/test/helper.js'
+import { additionalDependencies } from './helper.js'
+
+process.setMaxListeners(100)
+setFixturesDir(resolve(import.meta.dirname, './fixtures'))
+setAdditionalDependencies(additionalDependencies)
+
+const files = ['services/frontend/.output/server/index.mjs']
+
+const htmlContents = ['<script>window.__NUXT__={}']
+
+function verifyStandalone (_, url) {
+  return verifyHTMLViaHTTP(url, '/', [htmlContents])
+}
+
+async function verifyComposerOnPrefix (_, url) {
+  await verifyHTMLViaHTTP(url, '/frontend', [htmlContents])
+  await verifyHTMLViaHTTP(url, '/frontend/', [htmlContents])
+}
+
+async function verifyComposerOnAutodetectedPrefix (_, url) {
+  await verifyHTMLViaHTTP(url, '/nested/base/dir', [htmlContents])
+  await verifyHTMLViaHTTP(url, '/nested/base/dir/', [htmlContents])
+}
+
+const configurations = [
+  {
+    id: 'standalone',
+    name: 'Nuxt (standalone)',
+    files,
+    checks: [verifyStandalone],
+    language: 'js',
+    prefix: '',
+  },
+  {
+    id: 'composer-with-prefix',
+    name: 'Nuxt (in composer with prefix)',
+    files: [...files, ...internalApplicationsFiles],
+    checks: [
+      verifyComposerOnPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'ts',
+    prefix: '/frontend',
+  },
+  {
+    id: 'composer-without-prefix',
+    name: 'Nuxt (in composer without prefix)',
+    files,
+    checks: [
+      verifyStandalone,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '',
+  },
+  {
+    id: 'composer-autodetect-prefix',
+    name: 'Nuxt (in composer with autodetected prefix)',
+    files,
+    checks: [
+      verifyComposerOnAutodetectedPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '/nested/base/dir',
+  },
+  {
+    id: 'composer-custom-commands',
+    name: 'Nuxt (in composer with prefix using custom commands)',
+    files,
+    checks: [
+      verifyComposerOnPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '/frontend',
+  },
+  {
+    id: 'ssr-standalone',
+    name: 'Nuxt SSR (standalone)',
+    files,
+    checks: [verifyFrontendOnRoot],
+    language: 'js',
+    prefix: '',
+  },
+  {
+    id: 'ssr-with-prefix',
+    name: 'Nuxt SSR (in composer with prefix)',
+    files: [...files, ...internalApplicationsFiles],
+    checks: [
+      verifyFrontendOnPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'ts',
+    prefix: '/frontend',
+  },
+  {
+    id: 'ssr-without-prefix',
+    name: 'Nuxt SSR (in composer without prefix)',
+    files,
+    checks: [
+      verifyFrontendOnRoot,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '',
+  },
+  {
+    id: 'ssr-autodetect-prefix',
+    name: 'Nuxt SSR (in composer with autodetected prefix)',
+    files,
+    checks: [
+      verifyFrontendOnAutodetectedPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '/nested/base/dir',
+  },
+  {
+    id: 'ssr-custom-commands',
+    name: 'Nuxt SSR (in composer with prefix using custom commands)',
+    files,
+    checks: [
+      verifyFrontendOnPrefix,
+      verifyPlatformaticGateway,
+      verifyPlatformaticService,
+    ],
+    language: 'js',
+    prefix: '/frontend',
+  },
+]
+
+verifyBuildAndProductionMode(configurations)

package/test/types/index.tst.ts

@@ -0,0 +1,34 @@
+import type { Configuration } from '@platformatic/foundation'
+import type { JSONSchemaType } from 'ajv'
+import { expect, test } from 'tstyche'
+import {
+  NuxtCapability,
+  type PlatformaticNuxtConfig,
+  create,
+  loadConfiguration,
+  packageJson,
+  schema,
+  schemaComponents,
+  supportedVersions,
+  version
+} from '../../index.js'
+
+test('Nuxt types', () => {
+  const config = {} as PlatformaticNuxtConfig
+
+  expect(loadConfiguration('/tmp', config)).type.toBe<Promise<Configuration<PlatformaticNuxtConfig>>>()
+  expect(create('/tmp', config)).type.toBe<Promise<NuxtCapability>>()
+  expect(create(config)).type.toBe<Promise<NuxtCapability>>()
+
+  expect(loadConfiguration).type.toBeCallableWith('/tmp', config)
+  expect(create).type.toBeCallableWith('/tmp', config)
+
+  expect(loadConfiguration('/tmp', config, {} as Parameters<typeof loadConfiguration>[2])).type.toBe<Promise<Configuration<PlatformaticNuxtConfig>>>()
+
+  expect(schema).type.toBe<JSONSchemaType<PlatformaticNuxtConfig>>()
+  expect(schemaComponents).type.toBe<{ nuxt: unknown }>()
+  expect(packageJson).type.toBe<Record<string, unknown>>()
+  expect(version).type.toBe<string>()
+  expect(supportedVersions).type.toBe<string>()
+  expect(new NuxtCapability('/tmp', config)).type.toBe<NuxtCapability>()
+})

package/test/version-check.test.js

@@ -0,0 +1,29 @@
+import { ok, rejects } from 'node:assert'
+import { resolve } from 'node:path'
+import { test } from 'node:test'
+import { swapVersion } from '../../basic/test/helper-version.js'
+import { getLogsFromFile, prepareRuntime, setFixturesDir } from '../../basic/test/helper.js'
+
+setFixturesDir(resolve(import.meta.dirname, './fixtures'))
+
+test('Nuxt version is checked in development', async t => {
+  const { runtime, root } = await prepareRuntime(t, 'standalone', false, null, async () => {
+    await swapVersion(t, import.meta.dirname, 'nuxt', '', '3.0.0')
+  })
+
+  await rejects(runtime.start())
+  const logs = await getLogsFromFile(root)
+
+  ok(logs.some(l => l.err?.message.includes('nuxt version 3.0.0 is not supported')))
+})
+
+test('Nuxt version is not checked in production', async t => {
+  const { runtime, root } = await prepareRuntime(t, 'standalone', true, null, async () => {
+    await swapVersion(t, import.meta.dirname, 'nuxt', '', '3.0.0')
+  })
+
+  await rejects(runtime.start())
+  const logs = await getLogsFromFile(root)
+
+  ok(!logs.some(l => l.err?.message.includes('nuxt version 3.0.0 is not supported')))
+})