@stone-js/starters 0.8.8 → 0.8.10

package/standard-service-declarative/package.json

@@ -14,21 +14,22 @@
     "build": "stone build",
     "preview": "stone preview dist/server.mjs",
     "typings": "stone typings",
-    "test": "vitest run",
-    "test:cvg": "npm run test -- --coverage"
+    "test": "stone test",
+    "test:cvg": "stone test --coverage"
   },
   "dependencies": {
-    "@stone-js/pipeline": "^0.8.8",
-    "@stone-js/http-core": "^0.8.8",
-    "@stone-js/node-http-adapter": "^0.8.8",
-    "@stone-js/router": "^0.8.8",
-    "@stone-js/core": "^0.8.8"
+    "@stone-js/pipeline": "^0.8.10",
+    "@stone-js/http-core": "^0.8.10",
+    "@stone-js/node-http-adapter": "^0.8.10",
+    "@stone-js/router": "^0.8.10",
+    "@stone-js/core": "^0.8.10"
   },
   "devDependencies": {
     "@babel/plugin-proposal-decorators": "^7.25.9",
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-typescript": "^7.27.0",
-    "@stone-js/cli": "^0.8.8",
+    "@stone-js/cli": "^0.8.10",
+    "@stone-js/testing": "^0.8.10",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"

package/standard-service-declarative/tests/Application.spec.ts

@@ -1,100 +1,28 @@
-import { ILogger } from '@stone-js/core'
-import { IncomingHttpEvent } from '@stone-js/http-core'
-import { WelcomeService } from '../app/services/WelcomeService'
-import { WelcomeEventHandler } from '../app/handlers/WelcomeEventHandler'
-
-// We must mock decorators to lighten the test environment
-vi.mock(import('@stone-js/core'), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    Service: vi.fn(() => vi.fn())
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock(import('@stone-js/router'), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    EventHandler: vi.fn(() => vi.fn()),
-    Get: vi.fn(() => vi.fn())
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock(import('@stone-js/http-core'), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    JsonHttpResponse: vi.fn(() => vi.fn())
-  }
-})
-
-describe('WelcomeService', () => {
-  let mockedLogger: ILogger
-  let service: WelcomeService
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn()
-    } as unknown as ILogger
-
-    service = new WelcomeService({ logger: mockedLogger })
-  })
-
-  it('should build a branded welcome message for the given name', () => {
-    // Act
-    const response = service.welcome('Stone')
-
-    // Assert
-    expect(response.message).toBe('Hello Stone! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(response.framework).toMatchObject({
-      name: 'Stone.js',
-      tagline: 'The continuum framework',
-      docs: 'https://stonejs.dev',
-      github: 'https://github.com/stone-foundation/stone-js-framework'
-    })
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome Stone')
-  })
-})
-
-describe('WelcomeEventHandler', () => {
-  let mockedLogger: ILogger
-  let handler: WelcomeEventHandler
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn()
-    } as unknown as ILogger
-
-    handler = new WelcomeEventHandler({ welcomeService: new WelcomeService({ logger: mockedLogger }) })
-  })
-
-  it('should welcome the name carried by the event', () => {
-    // Arrange
-    const event = { get: () => 'World' } as unknown as IncomingHttpEvent
-
-    // Act
-    const response = handler.welcome(event)
-
-    // Assert
-    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
+import { createTestApp, makeIncomingHttpEvent } from '@stone-js/testing'
+
+/**
+ * The whole application, booted in memory and asked a real question.
+ *
+ * Nothing is mocked and nothing is listed: `createTestApp()` discovers `app/**`, and the event goes
+ * through the same kernel production runs. If this passes the application works; if it fails the
+ * application is broken. That is the only kind of test worth shipping in a starter — the previous one
+ * stubbed out the framework's own decorators, which meant it could pass while nothing worked.
+ */
+describe('Application', () => {
+  it('answers the caller', async () => {
+    const app = await createTestApp()
+
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/?name=Ada' }))
+
+    expect(response.statusCode).toBe(200)
+    expect(response.json()).toMatchObject({ message: expect.stringContaining('Ada') })
   })
 
-  it('should fall back to the default name when the event carries none', () => {
-    // Arrange
-    const event = { get: (_key: string, fallback: string) => fallback } as unknown as IncomingHttpEvent
+  it('answers when nobody says who they are', async () => {
+    const app = await createTestApp()
 
-    // Act
-    const response = handler.welcome(event)
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/' }))
 
-    // Assert
-    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
+    expect(response.statusCode).toBe(200)
   })
 })

package/standard-service-imperative/package.json

@@ -13,21 +13,22 @@
     "build": "stone build",
     "preview": "stone preview dist/server.mjs",
     "typings": "stone typings",
-    "test": "vitest run",
-    "test:cvg": "npm run test -- --coverage"
+    "test": "stone test",
+    "test:cvg": "stone test --coverage"
   },
   "dependencies": {
-    "@stone-js/pipeline": "^0.8.8",
-    "@stone-js/http-core": "^0.8.8",
-    "@stone-js/node-http-adapter": "^0.8.8",
-    "@stone-js/router": "^0.8.8",
-    "@stone-js/core": "^0.8.8"
+    "@stone-js/pipeline": "^0.8.10",
+    "@stone-js/http-core": "^0.8.10",
+    "@stone-js/node-http-adapter": "^0.8.10",
+    "@stone-js/router": "^0.8.10",
+    "@stone-js/core": "^0.8.10"
   },
   "devDependencies": {
     "@babel/plugin-proposal-decorators": "^7.25.9",
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-typescript": "^7.27.0",
-    "@stone-js/cli": "^0.8.8",
+    "@stone-js/cli": "^0.8.10",
+    "@stone-js/testing": "^0.8.10",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"

package/standard-service-imperative/tests/Application.spec.ts

@@ -1,84 +1,28 @@
-import { ILogger } from '@stone-js/core'
-import { IncomingHttpEvent } from '@stone-js/http-core'
-import { WelcomeService } from '../app/services/welcomeService'
-import { WelcomeEventHandler } from '../app/handlers/welcomeEventHandler'
-
-describe('WelcomeService', () => {
-  let mockedLogger: ILogger
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn()
-    } as unknown as ILogger
-  })
-
-  it('should build a welcome message for the given name', () => {
-    // Arrange
-    const service = WelcomeService({ logger: mockedLogger })
-
-    // Act
-    const response = service.welcome('Stone')
-
-    // Assert
-    expect(response.message).toBe('Hello Stone! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(response.framework).toMatchObject({
-      name: 'Stone.js',
-      tagline: 'The continuum framework',
-      docs: 'https://stonejs.dev',
-      github: 'https://github.com/stone-foundation/stone-js-framework'
-    })
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome Stone')
-  })
-})
-
-describe('WelcomeEventHandler', () => {
-  let mockedLogger: ILogger
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn()
-    } as unknown as ILogger
-  })
-
-  it('should create a functional event handler', () => {
-    // Arrange
-    const welcomeService = WelcomeService({ logger: mockedLogger })
-
-    // Act
-    const handler = WelcomeEventHandler({ welcomeService })
-
-    // Assert
-    expect(handler).toBeTypeOf('function')
-  })
-
-  it('should welcome the name carried by the event', () => {
-    // Arrange
-    const welcomeService = WelcomeService({ logger: mockedLogger })
-    const handler = WelcomeEventHandler({ welcomeService })
-    const event = { get: () => 'World' } as unknown as IncomingHttpEvent
-
-    // Act
-    const response = handler(event)
-
-    // Assert
-    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
+import { createTestApp, makeIncomingHttpEvent } from '@stone-js/testing'
+
+/**
+ * The whole application, booted in memory and asked a real question.
+ *
+ * Nothing is mocked and nothing is listed: `createTestApp()` discovers `app/**`, and the event goes
+ * through the same kernel production runs. If this passes the application works; if it fails the
+ * application is broken. That is the only kind of test worth shipping in a starter — the previous one
+ * stubbed out the framework's own decorators, which meant it could pass while nothing worked.
+ */
+describe('Application', () => {
+  it('answers the caller', async () => {
+    const app = await createTestApp()
+
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/?name=Ada' }))
+
+    expect(response.statusCode).toBe(200)
+    expect(response.json()).toMatchObject({ message: expect.stringContaining('Ada') })
   })
 
-  it('should fall back to the default name when the event carries none', () => {
-    // Arrange
-    const welcomeService = WelcomeService({ logger: mockedLogger })
-    const handler = WelcomeEventHandler({ welcomeService })
-    const event = { get: (_key: string, fallback: string) => fallback } as unknown as IncomingHttpEvent
+  it('answers when nobody says who they are', async () => {
+    const app = await createTestApp()
 
-    // Act
-    const response = handler(event)
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/' }))
 
-    // Assert
-    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
-    expect(response.framework.name).toBe('Stone.js')
-    expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
+    expect(response.statusCode).toBe(200)
   })
 })

package/basic-react-declarative/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts', 'app/**/*.tsx'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      thresholds: {
-        100: true
-      },
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    },
-  }
-});

package/basic-react-imperative/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts', 'app/**/*.tsx'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      thresholds: {
-        100: true
-      },
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    },
-  }
-});

package/basic-service-declarative/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      thresholds: {
-        100: true
-      },
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    },
-  }
-});

package/basic-service-imperative/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      thresholds: {
-        100: true
-      },
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    },
-  }
-});

package/continuum-showcase/tests/HomePage.spec.tsx

@@ -1,41 +0,0 @@
-import { renderToString } from 'react-dom/server'
-import { HomePage } from '../app/pages/HomePage'
-
-// Mock the page decorator so the class can be instantiated without a running app context.
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    Page: vi.fn(() => vi.fn())
-  }
-})
-
-describe('HomePage', () => {
-  it('returns the domain message from handle', () => {
-    // Arrange
-    const page = new HomePage()
-
-    // Act
-    const data = page.handle()
-
-    // Assert
-    expect(data.message).toBe('Write your domain once. Stone.js applies the context.')
-  })
-
-  it('renders the Stone.js logo and the message', () => {
-    // Arrange
-    const page = new HomePage()
-
-    // Act
-    const html = renderToString(page.render({ data: page.handle() } as any))
-
-    // Assert: the premium welcome hero renders the Stone.js logo (Vite inlines the small SVG
-    // as a data URI), the brand title and the domain message.
-    expect(html).toContain('stone-welcome')
-    expect(html).toContain('<img')
-    expect(html).toContain('image/svg+xml')
-    expect(html).toContain('alt="Stone.js"')
-    expect(html).toContain('Stone.js')
-    expect(html).toContain('Write your domain once')
-  })
-})

package/continuum-showcase/vitest.config.ts

@@ -1,31 +0,0 @@
-import { fileURLToPath } from 'node:url'
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  // Mirror the CLI's static-asset aliases (see stone.config.mjs) so component imports like
-  // `import logo from '@img/logo.svg'` also resolve under the test runner.
-  resolve: {
-    alias: {
-      '@img': fileURLToPath(new URL('./assets/images', import.meta.url)),
-      '@css': fileURLToPath(new URL('./assets/css', import.meta.url)),
-      '@assets': fileURLToPath(new URL('./assets', import.meta.url))
-    }
-  },
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts', 'app/**/*.tsx'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    }
-  }
-})

package/full-react-declarative/tests/AppLayout.spec.ts

@@ -1,51 +0,0 @@
-import { renderToString } from 'react-dom/server'
-import { AppLayout } from '../app/layout/AppLayout/AppLayout'
-
-// We must mock decorators and router-bound components to lighten the test environment
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    PageLayout: vi.fn(() => vi.fn()),
-    StoneLink: ({ children }: any) => children,
-    StoneOutlet: ({ children }: any) => children
-  }
-})
-
-describe('AppLayout', () => {
-  let layout: AppLayout
-
-  beforeEach(() => {
-    layout = new AppLayout({} as any)
-  })
-
-  const render = (): string => {
-    const container = {
-      make: () => ({ getUser: () => undefined })
-    }
-    return renderToString(layout.render({ container, children: null } as any))
-  }
-
-  it('should create an App Layout instance', () => {
-    // Assert
-    expect(layout).toBeInstanceOf(AppLayout)
-  })
-
-  it('should render the real Stone.js logo', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('/logo.svg')
-    expect(html).toContain('alt="Stone.js"')
-  })
-
-  it('should render the unauthenticated header', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('Login')
-    expect(html).toContain('Stone.js')
-  })
-})

package/full-react-declarative/tests/HomePage.spec.ts

@@ -1,38 +0,0 @@
-import { renderToString } from 'react-dom/server'
-import { HomePage } from '../app/pages/home/HomePage'
-
-// We must mock the @Page decorator and router-bound components to lighten the test environment
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    Page: vi.fn(() => vi.fn()),
-    StoneLink: ({ children }: any) => children
-  }
-})
-
-describe('HomePage', () => {
-  const render = (): string => {
-    const page = new HomePage()
-    return renderToString(page.render())
-  }
-
-  it('should render the premium Stone.js welcome hero with the real logo', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('/logo.svg')
-    expect(html).toContain('alt="Stone.js"')
-  })
-
-  it('should render the Welcome to Stone.js headline', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('Welcome')
-    expect(html).toContain('Stone.js')
-    expect(html).toContain('stone-welcome')
-  })
-})

package/full-react-declarative/vitest.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
-    coverage: {
-      provider: 'v8',
-      include: ['app/**/*.ts', 'app/**/*.tsx'],
-      reporter: ['text', 'html'],
-      reportsDirectory: './coverage',
-      thresholds: {
-        100: true
-      },
-      watermarks: {
-        statements: [60, 80],
-        functions: [60, 80],
-        branches: [60, 80],
-        lines: [60, 80]
-      }
-    },
-  }
-});

package/full-react-imperative/tests/HomePage.spec.ts

@@ -1,45 +0,0 @@
-import { renderToString } from 'react-dom/server'
-import { HomePage } from '../app/pages/home/HomePage'
-
-// We must mock router-bound components to lighten the test environment
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    StoneLink: ({ children }: any) => children
-  }
-})
-
-describe('HomePage', () => {
-  const render = (data: any[] = []): string => {
-    const page = HomePage({ postService: {} as any })
-    return renderToString(page.render?.({ data } as any))
-  }
-
-  it('should render the premium Stone.js welcome hero with the real logo', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('/logo.svg')
-    expect(html).toContain('alt="Stone.js"')
-  })
-
-  it('should render the Welcome to Stone.js headline', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('Welcome')
-    expect(html).toContain('Stone.js')
-    expect(html).toContain('stone-welcome')
-  })
-
-  it('should reflect the number of published posts in the lead', () => {
-    // Act
-    const html = render([{ id: 1 }, { id: 2 }])
-
-    // Assert
-    expect(html).toContain('2 posts')
-  })
-})

package/full-react-imperative/tests/LayoutHeader.spec.ts

@@ -1,39 +0,0 @@
-import { createElement } from 'react'
-import { renderToString } from 'react-dom/server'
-import { LayoutHeader } from '../app/components/LayoutHeader/LayoutHeader'
-
-// We must mock router-bound components to lighten the test environment
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    StoneLink: ({ children }: any) => children
-  }
-})
-
-describe('LayoutHeader', () => {
-  const render = (): string => {
-    const container = {
-      make: (key: string) => key === 'event' ? { getUser: () => undefined } : {}
-    } as any
-    return renderToString(createElement(LayoutHeader, { container }))
-  }
-
-  it('should render the real Stone.js logo', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('/logo.svg')
-    expect(html).toContain('alt="Stone.js"')
-  })
-
-  it('should render the Stone.js brand for an unauthenticated visitor', () => {
-    // Act
-    const html = render()
-
-    // Assert
-    expect(html).toContain('Stone.js')
-    expect(html).toContain('app-navbar')
-  })
-})