@inspecto-dev/cli 0.2.0-alpha.5 → 0.2.0-alpha.6

package/tests/instructions.test.ts

@@ -0,0 +1,61 @@
+import { describe, expect, it, vi, beforeEach } from 'vitest'
+import { printNextJsManualInstructions, printNuxtManualInstructions } from '../src/instructions.js'
+import { log } from '../src/utils/logger.js'
+
+vi.mock('../src/utils/logger.js', () => ({
+  log: {
+    blank: vi.fn(),
+    hint: vi.fn(),
+    copyableCodeBlock: vi.fn(),
+  },
+}))
+
+describe('manual framework instructions', () => {
+  beforeEach(() => {
+    vi.resetAllMocks()
+  })
+
+  it('prints detailed Next.js instructions with step-by-step code blocks', () => {
+    printNextJsManualInstructions()
+
+    expect(log.blank).toHaveBeenCalled()
+    expect(log.hint).toHaveBeenCalledWith('Next.js requires manual setup in the current version.')
+    expect(log.hint).toHaveBeenCalledWith(
+      '1. Update `next.config.mjs` to register the Inspecto webpack plugin:',
+    )
+    expect(log.copyableCodeBlock).toHaveBeenCalledWith(
+      expect.arrayContaining([
+        "import { webpackPlugin as inspecto } from '@inspecto-dev/plugin'",
+        'export default nextConfig',
+      ]),
+    )
+    expect(log.hint).toHaveBeenCalledWith(
+      '2. Initialize `@inspecto-dev/core` from a client component such as `app/layout.tsx` or `pages/_app.tsx`:',
+    )
+    expect(log.hint).toHaveBeenCalledWith(
+      '3. Restart your Next.js dev server after updating the config.',
+    )
+  })
+
+  it('prints detailed Nuxt instructions with step-by-step code blocks', () => {
+    printNuxtManualInstructions()
+
+    expect(log.blank).toHaveBeenCalled()
+    expect(log.hint).toHaveBeenCalledWith('Nuxt requires manual setup in the current version.')
+    expect(log.hint).toHaveBeenCalledWith(
+      '1. Update `nuxt.config.ts` to register the Inspecto Vite plugin:',
+    )
+    expect(log.copyableCodeBlock).toHaveBeenCalledWith(
+      expect.arrayContaining([
+        "import { vitePlugin as inspecto } from '@inspecto-dev/plugin'",
+        'export default defineNuxtConfig({',
+      ]),
+    )
+    expect(log.hint).toHaveBeenCalledWith(
+      '2. Create `plugins/inspecto.client.ts` to mount `@inspecto-dev/core` in development:',
+    )
+    expect(log.hint).toHaveBeenCalledWith(
+      '3. Restart your Nuxt dev server after updating the config.',
+    )
+  })
+})

package/tests/logger.test.ts

@@ -0,0 +1,100 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { log } from '../src/utils/logger.js'
+import { reportCommandError, writeCommandOutput } from '../src/utils/output.js'
+
+describe('logger copyable code blocks', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('prints copyable code without box drawing characters', () => {
+    const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {})
+
+    log.copyableCodeBlock(['const answer = 42', 'console.log(answer)'])
+
+    const output = consoleSpy.mock.calls.map(call => String(call[0]))
+
+    expect(output).not.toContain(expect.stringContaining('┌'))
+    expect(output).not.toContain(expect.stringContaining('│'))
+    expect(output).not.toContain(expect.stringContaining('└'))
+    expect(output).toContain('      const answer = 42')
+    expect(output).toContain('      console.log(answer)')
+  })
+})
+
+describe('command output utility', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('prints formatted JSON and skips the plain-text renderer in json mode', () => {
+    const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {})
+    const renderText = vi.fn()
+    const result = { status: 'ok', nested: { value: 1 } }
+
+    const returned = writeCommandOutput(result, true, renderText)
+
+    expect(returned).toBe(result)
+    expect(renderText).not.toHaveBeenCalled()
+    expect(consoleSpy).toHaveBeenCalledWith(JSON.stringify(result, null, 2))
+  })
+
+  it('uses the plain-text renderer when json mode is disabled', () => {
+    const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {})
+    const renderText = vi.fn()
+    const result = { status: 'ok' }
+
+    const returned = writeCommandOutput(result, false, renderText)
+
+    expect(returned).toBe(result)
+    expect(renderText).toHaveBeenCalledWith(result)
+    expect(consoleSpy).not.toHaveBeenCalled()
+  })
+
+  it('prints machine-safe JSON errors when json mode is enabled', () => {
+    const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+    const loggerSpy = vi.spyOn(log, 'error').mockImplementation(() => {})
+    const error = new Error('boom')
+    error.stack = 'Error: boom\n    at fake'
+
+    reportCommandError(error, { json: true })
+
+    expect(loggerSpy).not.toHaveBeenCalled()
+    expect(consoleErrorSpy).toHaveBeenCalledWith(
+      JSON.stringify(
+        {
+          status: 'error',
+          error: {
+            message: 'boom',
+          },
+        },
+        null,
+        2,
+      ),
+    )
+  })
+
+  it('includes the stack in JSON error output when debug mode is enabled', () => {
+    const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
+    const loggerSpy = vi.spyOn(log, 'error').mockImplementation(() => {})
+    const error = new Error('boom')
+    error.stack = 'Error: boom\n    at fake'
+
+    reportCommandError(error, { json: true, debug: true })
+
+    expect(loggerSpy).not.toHaveBeenCalled()
+    expect(consoleErrorSpy).toHaveBeenCalledWith(
+      JSON.stringify(
+        {
+          status: 'error',
+          error: {
+            message: 'boom',
+            stack: 'Error: boom\n    at fake',
+          },
+        },
+        null,
+        2,
+      ),
+    )
+  })
+})