@platformatic/nuxt 0.0.1 → 3.58.1

package/test/backlog.test.js

@@ -0,0 +1,88 @@
+import { deepStrictEqual } from 'node:assert'
+import { cp } from 'node:fs/promises'
+import path, { resolve } from 'node:path'
+import { test } from 'node:test'
+import { commonFixturesRoot, prepareRuntime, updateFile } from '../../basic/test/helper.js'
+import { updateConfigFile } from '../../runtime/test/helpers.js'
+
+const envs = {
+  dev: {
+    build: false,
+    production: false
+  },
+  production: {
+    build: true,
+    production: true
+  }
+}
+
+function waitServerOptions (runtime) {
+  const { promise, resolve } = Promise.withResolvers()
+
+  function listener (payload, _, application) {
+    if (application === 'frontend') {
+      runtime.removeListener('application:worker:event:serverOptions', listener)
+      resolve(payload)
+    }
+  }
+
+  runtime.on('application:worker:event:serverOptions', listener)
+
+  return promise
+}
+
+for (const [env, options] of Object.entries(envs)) {
+  test(`Nuxt application should properly use backlog option in ${env}`, async t => {
+    const { runtime } = await prepareRuntime({
+      t,
+      root: path.resolve(import.meta.dirname, './fixtures/standalone'),
+      build: options.build,
+      production: options.production,
+      async additionalSetup (root) {
+        return updateConfigFile(resolve(root, 'services/frontend/platformatic.application.json'), config => {
+          config.server ??= {}
+          config.server.backlog = 100
+        })
+      }
+    })
+
+    const promise = waitServerOptions(runtime)
+
+    await runtime.start()
+    const serverOptions = await promise
+    deepStrictEqual(serverOptions.backlog, 100)
+  })
+
+  test(`Nuxt application should properly use backlog option in ${env} when using custom commands`, async t => {
+    const { runtime } = await prepareRuntime({
+      t,
+      root: path.resolve(import.meta.dirname, './fixtures/composer-custom-commands'),
+      build: options.build,
+      production: options.production,
+      async additionalSetup (root, config) {
+        for (const type of ['backend', 'composer']) {
+          await cp(resolve(commonFixturesRoot, `${type}-js`), resolve(root, `services/${type}`), {
+            recursive: true
+          })
+        }
+
+        await updateFile(resolve(root, 'services/composer/routes/root.js'), contents => {
+          return contents.replace('$PREFIX', '/frontend')
+        })
+
+        await updateConfigFile(resolve(root, 'services/frontend/platformatic.application.json'), config => {
+          config.server ??= {}
+          config.server.backlog = 100
+        })
+
+        config.applications[0].useHttp = true
+      }
+    })
+
+    const promise = waitServerOptions(runtime)
+
+    await runtime.start()
+    const serverOptions = await promise
+    deepStrictEqual(serverOptions.backlog, 100)
+  })
+}

package/test/development.test.js

@@ -0,0 +1,216 @@
+import { resolve } from 'node:path'
+import {
+  createRuntime,
+  prepareRuntimeWithApplications,
+  setAdditionalDependencies,
+  setFixturesDir,
+  updateFile,
+  verifyDevelopmentMode,
+  verifyHTMLViaHTTP,
+  verifyHTMLViaInject,
+  verifyJSONViaHTTP,
+  verifyJSONViaInject
+} from '../../basic/test/helper.js'
+import { additionalDependencies } from './helper.js'
+
+process.setMaxListeners(100)
+setFixturesDir(resolve(import.meta.dirname, './fixtures'))
+setAdditionalDependencies(additionalDependencies)
+
+const htmlContents = ['<script>window.__NUXT__={}']
+const htmlContentsSSR = [/Hello from v\d+ t\d+/]
+
+async function verifyStandalone (
+  t,
+  configuration,
+  _language,
+  htmlContents,
+  _hmrUrl,
+  _hmrProtocol,
+  _websocketHMRHandler,
+  pauseTimeout,
+  additionalSetup
+) {
+  const { url } = await createRuntime(t, configuration, pauseTimeout, false, null, additionalSetup)
+  await verifyHTMLViaHTTP(url, '/', htmlContents)
+}
+
+async function verifyComposerWithPrefix (
+  t,
+  configuration,
+  language,
+  htmlContents,
+  _hmrUrl,
+  _hmrProtocol,
+  _websocketHMRHandler,
+  pauseTimeout,
+  additionalSetup
+) {
+  const { runtime, url } = await prepareRuntimeWithApplications(
+    t,
+    configuration,
+    false,
+    language,
+    '/frontend',
+    pauseTimeout,
+    additionalSetup
+  )
+
+  await verifyHTMLViaHTTP(url, '/frontend/', htmlContents)
+  await verifyHTMLViaInject(runtime, 'composer', '/frontend', htmlContents)
+
+  await verifyJSONViaHTTP(url, '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaHTTP(url, '/frontend/on-composer', 200, { ok: true })
+  await verifyJSONViaHTTP(url, '/backend/example', 200, { hello: 'foobar' })
+
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/frontend/on-composer', 200, { ok: true })
+  await verifyJSONViaInject(runtime, 'backend', 'GET', '/example', 200, { hello: 'foobar' })
+}
+
+async function verifyComposerWithoutPrefix (
+  t,
+  configuration,
+  language,
+  htmlContents,
+  _hmrUrl,
+  _hmrProtocol,
+  _websocketHMRHandler,
+  pauseTimeout,
+  additionalSetup
+) {
+  const { runtime, url } = await prepareRuntimeWithApplications(
+    t,
+    configuration,
+    false,
+    language,
+    '',
+    pauseTimeout,
+    async root => {
+      await updateFile(resolve(root, 'services/composer/platformatic.json'), contents => {
+        const json = JSON.parse(contents)
+        json.gateway.applications[1].proxy = { prefix: '' }
+        return JSON.stringify(json, null, 2)
+      })
+    }
+  )
+
+  await verifyHTMLViaHTTP(url, '/', htmlContents)
+  await verifyHTMLViaInject(runtime, 'composer', '/', htmlContents)
+
+  await verifyJSONViaHTTP(url, '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaHTTP(url, '/on-composer', 200, { ok: true })
+  await verifyJSONViaHTTP(url, '/backend/example', 200, { hello: 'foobar' })
+
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/on-composer', 200, { ok: true })
+  await verifyJSONViaInject(runtime, 'backend', 'GET', '/example', 200, { hello: 'foobar' })
+}
+
+async function verifyComposerWithAutodetectPrefix (
+  t,
+  configuration,
+  language,
+  htmlContents,
+  _hmrUrl,
+  _hmrProtocol,
+  _websocketHMRHandler,
+  pauseTimeout,
+  additionalSetup
+) {
+  const { runtime, url } = await prepareRuntimeWithApplications(
+    t,
+    configuration,
+    false,
+    language,
+    '/nested/base/dir',
+    pauseTimeout,
+    additionalSetup
+  )
+
+  await verifyHTMLViaHTTP(url, '/nested/base/dir/', htmlContents)
+  await verifyHTMLViaInject(runtime, 'composer', '/nested/base/dir', htmlContents)
+
+  await verifyJSONViaHTTP(url, '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaHTTP(url, '/nested/base/dir/on-composer', 200, { ok: true })
+  await verifyJSONViaHTTP(url, '/backend/example', 200, { hello: 'foobar' })
+
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/example', 200, { hello: 'foobar' })
+  await verifyJSONViaInject(runtime, 'composer', 'GET', '/nested/base/dir/on-composer', 200, { ok: true })
+  await verifyJSONViaInject(runtime, 'backend', 'GET', '/example', 200, { hello: 'foobar' })
+}
+
+const configurations = [
+  {
+    id: 'standalone',
+    name: 'Nuxt (standalone)',
+    check: verifyStandalone,
+    htmlContents,
+    language: 'js'
+  },
+  {
+    id: 'composer-with-prefix',
+    name: 'Nuxt (in composer with prefix)',
+    check: verifyComposerWithPrefix,
+    htmlContents,
+    language: 'js'
+  },
+  {
+    id: 'composer-without-prefix',
+    name: 'Nuxt (in composer without prefix)',
+    check: verifyComposerWithoutPrefix,
+    htmlContents,
+    language: 'js'
+  },
+  {
+    id: 'composer-autodetect-prefix',
+    name: 'Nuxt (in composer with autodetected prefix)',
+    check: verifyComposerWithAutodetectPrefix,
+    htmlContents,
+    language: 'js'
+  },
+  {
+    id: 'composer-custom-commands',
+    name: 'Nuxt (in composer with prefix using custom commands)',
+    check: verifyComposerWithPrefix,
+    htmlContents,
+    language: 'js'
+  },
+  {
+    id: 'ssr-standalone',
+    name: 'Nuxt SSR (standalone)',
+    check: verifyStandalone,
+    htmlContents: htmlContentsSSR,
+    language: 'js'
+  },
+  {
+    id: 'ssr-with-prefix',
+    name: 'Nuxt SSR (in composer with prefix)',
+    check: verifyComposerWithPrefix,
+    htmlContents: htmlContentsSSR,
+    language: 'ts'
+  },
+  {
+    id: 'ssr-without-prefix',
+    name: 'Nuxt SSR (in composer without prefix)',
+    check: verifyComposerWithoutPrefix,
+    htmlContents: htmlContentsSSR,
+    language: 'js'
+  },
+  {
+    id: 'ssr-autodetect-prefix',
+    name: 'Nuxt SSR (in composer with autodetected prefix)',
+    check: verifyComposerWithAutodetectPrefix,
+    htmlContents: htmlContentsSSR,
+    language: 'js'
+  },
+  {
+    id: 'ssr-custom-commands',
+    name: 'Nuxt SSR (in composer with prefix using custom commands)',
+    check: verifyComposerWithPrefix,
+    htmlContents: htmlContentsSSR,
+    language: 'js'
+  }
+]
+
+verifyDevelopmentMode(configurations)

package/test/fetch.test.js

@@ -0,0 +1,67 @@
+import { ok, strictEqual } from 'node:assert'
+import { cp } from 'node:fs/promises'
+import { resolve } from 'node:path'
+import { test } from 'node:test'
+import { request } from 'undici'
+import {
+  buildRuntime,
+  commonFixturesRoot,
+  prepareRuntime,
+  setAdditionalDependencies,
+  setFixturesDir,
+  startRuntime,
+  updateFile
+} from '../../basic/test/helper.js'
+import { additionalDependencies } from './helper.js'
+
+process.setMaxListeners(100)
+setFixturesDir(resolve(import.meta.dirname, './fixtures'))
+setAdditionalDependencies(additionalDependencies)
+
+function decodeHtmlEntities (str) {
+  return str
+    .replace(/"/g, '"')
+    .replace(/&/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&#39;/g, "'")
+}
+
+test('fetch() should work with string URL and Request object in Nuxt app', async t => {
+  const { runtime, root } = await prepareRuntime(t, 'fetch-test', true, null, async root => {
+    for (const type of ['backend', 'composer']) {
+      await cp(resolve(commonFixturesRoot, `${type}-js`), resolve(root, `services/${type}`), {
+        recursive: true
+      })
+    }
+
+    await updateFile(resolve(root, 'services/composer/routes/root.js'), contents => {
+      return contents.replace('$PREFIX', '/frontend')
+    })
+  })
+
+  await buildRuntime(root)
+
+  const url = await startRuntime(t, runtime)
+
+  const response = await request(`${url}/frontend/`)
+  strictEqual(response.statusCode, 200, `Expected 200 but got ${response.statusCode}`)
+
+  const html = await response.body.text()
+  ok(html.includes('Hello from v'), 'Page should render successfully')
+
+  const preMatch = html.match(/<pre[^>]*id="fetch-results"[^>]*>([\s\S]*?)<\/pre>/)
+  ok(preMatch, 'Should find fetch-results pre tag')
+
+  const decoded = decodeHtmlEntities(preMatch[1].trim())
+  const fetchResults = JSON.parse(decoded)
+
+  ok(
+    fetchResults.stringUrl?.ok === true,
+    `fetch with string URL should succeed: ${JSON.stringify(fetchResults.stringUrl)}`
+  )
+  ok(
+    fetchResults.requestObject?.ok === true,
+    `fetch with Request object should succeed: ${JSON.stringify(fetchResults.requestObject)}`
+  )
+})

package/test/fixtures/composer-autodetect-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/composer-autodetect-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/composer-autodetect-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/composer-autodetect-prefix/services/frontend/nuxt.config.js

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

package/test/fixtures/composer-autodetect-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/composer-autodetect-prefix/services/frontend/platformatic.application.json

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

package/test/fixtures/composer-custom-commands/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "test",
+  "private": true,
+  "workspaces": [
+    "services/*"
+  ],
+  "dependencies": {
+    "@platformatic/runtime": "^2.3.1",
+    "platformatic": "^2.3.1"
+  }
+}

package/test/fixtures/composer-custom-commands/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/composer-custom-commands/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/composer-custom-commands/services/frontend/nuxt.config.js

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

package/test/fixtures/composer-custom-commands/services/frontend/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "nuxt",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev --host 127.0.0.1 --port 0",
+    "build": "nuxt build",
+    "start": "node .output/server/index.mjs"
+  },
+  "dependencies": {
+    "@platformatic/nuxt": "^3.52.4",
+    "nuxt": "^4.4.8",
+    "vue": "^3.5.22"
+  }
+}

package/test/fixtures/composer-custom-commands/services/frontend/platformatic.application.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://schemas.platformatic.dev/@platformatic/nuxt/3.52.4.json",
+  "application": {
+    "basePath": "/frontend",
+    "commands": {
+      "build": "npm run build",
+      "development": "npm run dev",
+      "production": "npm run start"
+    }
+  }
+}

package/test/fixtures/composer-with-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/composer-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/composer-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/composer-with-prefix/services/frontend/nuxt.config.js

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

package/test/fixtures/composer-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/composer-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/composer-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/composer-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/composer-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>