@stone-js/starters 0.8.7 → 0.8.9

package/README.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/npm/l/@stone-js/starters)](https://opensource.org/licenses/MIT)
 [![Maintenance](https://img.shields.io/maintenance/yes/2026)](https://stonejs.dev)
-[![Used by Stone CLI](https://img.shields.io/badge/Used%20by-Stone%20CLI-blue)](https://github.com/stone-foundation/stone-js-cli)
+[![Used by Stone CLI](https://img.shields.io/badge/Used%20by-Stone%20CLI-blue)](https://github.com/stone-foundation/stone-js-framework)
 
 This repository contains official **starter templates** for Stone.js applications.
 
@@ -98,4 +98,4 @@ Explore the full documentation: [https://stonejs.dev](https://stonejs.dev)
 
 ## Contributing
 
-See [Contributing Guide](https://github.com/stone-foundation/stone-js-starters/blob/main/CONTRIBUTING.md)
+See [Contributing Guide](https://github.com/stone-foundation/stone-js-framework/blob/main/CONTRIBUTING.md)

package/basic-react-declarative/app/Application.tsx

@@ -1,6 +1,5 @@
 import { JSX } from 'react'
 import { Browser } from '@stone-js/browser-adapter'
-import { NodeConsole } from '@stone-js/node-cli-adapter'
 import { ILogger, LogLevel, Promiseable, StoneApp } from '@stone-js/core'
 import { ReactIncomingEvent, UseReact, HeadContext, IPage, PageHeadContext, PageRenderContext } from '@stone-js/use-react'
 
@@ -15,7 +14,6 @@ import { ReactIncomingEvent, UseReact, HeadContext, IPage, PageHeadContext, Page
  */
 @Browser()
 @UseReact()
-@NodeConsole()
 @StoneApp({ logger: { level: LogLevel.INFO } })
 export class Application implements IPage<ReactIncomingEvent> {
   /**

package/basic-react-declarative/package.json

@@ -14,22 +14,22 @@
     "build": "stone build",
     "preview": "stone preview",
     "build:ssr": "stone build --ssr",
-    "test": "vitest run",
-    "test:cvg": "npm run test -- --coverage"
+    "test": "stone test",
+    "test:cvg": "stone test --coverage"
   },
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@stone-js/core": "^0.8.7",
-    "@stone-js/use-react": "^0.8.7",
-    "@stone-js/browser-adapter": "^0.8.7",
-    "@stone-js/node-cli-adapter": "^0.8.7"
+    "@stone-js/core": "^0.8.9",
+    "@stone-js/use-react": "^0.8.9",
+    "@stone-js/browser-adapter": "^0.8.9"
   },
   "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.7",
+    "@stone-js/cli": "^0.8.9",
+    "@stone-js/testing": "^0.8.9",
     "@types/node": "^24.0.7",
     "@types/react": "^19.0.7",
     "@types/react-dom": "^19.0.3",

package/basic-react-declarative/public/favicon.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" width="96" height="96" role="img" aria-label="Stone.js">
+  <title>Stone.js</title>
+  <style>
+    .ink { stroke: #1B1613; }
+    @media (prefers-color-scheme: dark) { .ink { stroke: #EFE8DC; } }
+  </style>
+  <defs>
+    <linearGradient id="braise" gradientUnits="userSpaceOnUse" x1="22" y1="14" x2="74" y2="26.1">
+      <stop offset="0" stop-color="#FFC46B" />
+      <stop offset="1" stop-color="#FF5A1F" />
+    </linearGradient>
+  </defs>
+  <path class="ink" d="M 79.96 36.4 A 34 34 0 0 1 53.9 81.5" fill="none" stroke-width="11" stroke-linecap="round" opacity=".85" />
+  <path class="ink" d="M 42.1 81.5 A 34 34 0 0 1 16.05 36.4" fill="none" stroke-width="11" stroke-linecap="round" opacity=".85" />
+  <path d="M 22 26.1 A 34 34 0 0 1 74 26.1" fill="none" stroke="url(#braise)" stroke-width="11" stroke-linecap="round" />
+</svg>

package/basic-react-declarative/tests/Application.spec.ts

@@ -1,105 +1,30 @@
-import { ILogger } from '@stone-js/core'
-import { Application } from '../app/Application'
-import { renderToString } from 'react-dom/server'
-import { ReactIncomingEvent } from '@stone-js/use-react'
-
-// We must mock decorators to lighten the test environment
-vi.mock('@stone-js/core', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    StoneApp: vi.fn(() => vi.fn()),
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock('@stone-js/node-cli-adapter', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    NodeConsole: vi.fn(() => vi.fn()),
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock('@stone-js/browser-adapter', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    Browser: vi.fn(() => vi.fn()),
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock('@stone-js/use-react', async (importOriginal) => {
-  const actual: any = await importOriginal()
-  return {
-    ...actual,
-    UseReact: vi.fn(() => vi.fn()),
-  }
-})
-
-describe('Application', () => {
-  let app: Application
-  let mockedLogger: ILogger
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn(),
-    } as unknown as ILogger
-
-    app = new Application({ logger: mockedLogger })
-  })
-
-  it('should create an application instance', () => {
-    // Assert
-    expect(app).toBeInstanceOf(Application)
+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('Pages', () => {
+  it('renders the home page, data included', async () => {
+    const app = await createTestApp()
+
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/?name=Ada' }))
+
+    expect(response.statusCode).toBe(200)
+    // A page is a handler, so a rendered page is a response whose body is HTML. Query that HTML with
+    // whatever you already use (happy-dom, jsdom, Testing Library): none is bundled here.
+    expect(response.html()).toContain('Ada')
   })
 
-  it('get head values', async () => {
-    // Arrange
-    const event = { get: () => 'World' } as unknown as ReactIncomingEvent
+  it('renders without a name', async () => {
+    const app = await createTestApp()
 
-    // Act
-    const head = await app.head({ event })
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/' }))
 
-    // Assert
-    expect(head).toHaveProperty('metas')
-    expect(head.title).toContain('Welcome to Stone.js')
-    expect(head.title).toContain('World')
-    expect(head).toHaveProperty('description')
+    expect(response.statusCode).toBe(200)
   })
-
-  it('should handle incoming events', () => {
-    // Arrange
-    const expectedMessage = 'Hello World!'
-    const event = { get: () => 'World' } as unknown as ReactIncomingEvent
-
-    // Act
-    const response = app.handle(event) as { message: string }
-
-    // Assert
-    expect(response.message).toBe(expectedMessage)
-    expect(mockedLogger.info).toHaveBeenCalledWith(expectedMessage)
-  })
-
-  it('should render the message', () => {
-    // Arrange
-    const message = 'Hello World!'
-
-    // Act
-    const response = renderToString(app.render({ data: { message } } as any))
-
-    // Assert
-    expect(response).toContain(message)
-  })
-
-  it('should render the Stone.js logo', () => {
-    // Act
-    const response = renderToString(app.render({ data: { message: 'Hello World!' } } as any))
-
-    // Assert
-    expect(response).toContain('/logo.svg')
-    expect(response).toContain('alt="Stone.js"')
-  })
-})
+})

package/basic-react-imperative/app/Application.tsx

@@ -1,7 +1,6 @@
 import { JSX } from 'react'
 import { browserAdapterBlueprint } from '@stone-js/browser-adapter'
-import { defineConfig, IBlueprint, ILogger, isNotEmpty, Promiseable } from '@stone-js/core'
-import { defineCommand, FactoryCommandHandler, NODE_CONSOLE_PLATFORM, nodeConsoleAdapterBlueprint } from '@stone-js/node-cli-adapter'
+import { ILogger, Promiseable } from '@stone-js/core'
 import { defineStoneReactApp, HeadContext, IPage, PageHeadContext, PageRenderContext, ReactIncomingEvent } from '@stone-js/use-react'
 
 /**
@@ -73,23 +72,9 @@ export const FactoryHandler = ({ logger }: AppOptions): IPage<ReactIncomingEvent
 export const Application = defineStoneReactApp(
   FactoryHandler,
   { debug: true, isFactory: true },
-  [browserAdapterBlueprint, nodeConsoleAdapterBlueprint]
+  [browserAdapterBlueprint]
 )
 
-/**
- * Application configuration.
- */
-export const AppConfig = defineConfig({
-  afterConfigure (blueprint: IBlueprint) {
-    if (
-      isNotEmpty<FactoryCommandHandler>(FactoryHandler) &&
-      blueprint.is('stone.adapter.platform', NODE_CONSOLE_PLATFORM)
-    ) {
-      blueprint.set(defineCommand(FactoryHandler, { name: '*', isFactory: true }))
-    }
-  }
-})
-
 /**
  * Application options.
  */

package/basic-react-imperative/package.json

@@ -14,22 +14,22 @@
     "build": "stone build",
     "preview": "stone preview",
     "typings": "stone typings",
-    "test": "vitest run",
-    "test:cvg": "npm run test -- --coverage"
+    "test": "stone test",
+    "test:cvg": "stone test --coverage"
   },
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@stone-js/core": "^0.8.7",
-    "@stone-js/use-react": "^0.8.7",
-    "@stone-js/browser-adapter": "^0.8.7",
-    "@stone-js/node-cli-adapter": "^0.8.7"
+    "@stone-js/core": "^0.8.9",
+    "@stone-js/use-react": "^0.8.9",
+    "@stone-js/browser-adapter": "^0.8.9"
   },
   "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.7",
+    "@stone-js/cli": "^0.8.9",
+    "@stone-js/testing": "^0.8.9",
     "@types/node": "^24.0.7",
     "@types/react": "^19.0.7",
     "@types/react-dom": "^19.0.3",

package/basic-react-imperative/public/favicon.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" width="96" height="96" role="img" aria-label="Stone.js">
+  <title>Stone.js</title>
+  <style>
+    .ink { stroke: #1B1613; }
+    @media (prefers-color-scheme: dark) { .ink { stroke: #EFE8DC; } }
+  </style>
+  <defs>
+    <linearGradient id="braise" gradientUnits="userSpaceOnUse" x1="22" y1="14" x2="74" y2="26.1">
+      <stop offset="0" stop-color="#FFC46B" />
+      <stop offset="1" stop-color="#FF5A1F" />
+    </linearGradient>
+  </defs>
+  <path class="ink" d="M 79.96 36.4 A 34 34 0 0 1 53.9 81.5" fill="none" stroke-width="11" stroke-linecap="round" opacity=".85" />
+  <path class="ink" d="M 42.1 81.5 A 34 34 0 0 1 16.05 36.4" fill="none" stroke-width="11" stroke-linecap="round" opacity=".85" />
+  <path d="M 22 26.1 A 34 34 0 0 1 74 26.1" fill="none" stroke="url(#braise)" stroke-width="11" stroke-linecap="round" />
+</svg>

package/basic-react-imperative/tests/Application.spec.ts

@@ -1,91 +1,30 @@
-import { renderToString } from 'react-dom/server'
-import { ILogger, IncomingEvent } from '@stone-js/core'
-import { FactoryHandler, AppConfig } from '../app/Application'
-
-vi.mock('@stone-js/core', async (mod) => {
-  const actual: any = await mod()
-  return {
-    ...actual,
-    isNotEmpty: vi.fn(() => true),
-    defineConfig: (config: any) => config
-  }
-})
-
-describe('Application', () => {
-  let app: any
-  let mockedLogger: ILogger
-
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn(),
-    } as unknown as ILogger
-
-    app = FactoryHandler({ logger: mockedLogger })
-  })
-
-  it('should create an application instance', () => {
-    // Assert
-    expect(app).toBeInstanceOf(Object)
-  })
-
-  it('get head values', async () => {
-    // Arrange
-    const event = { get: () => 'World' } as unknown as IncomingEvent
-
-    // Act
-    const head = await app.head({ event })
-
-    // Assert
-    expect(head).toHaveProperty('metas')
-    expect(head.title).toContain('Welcome to Stone.js')
-    expect(head.title).toContain('World')
-    expect(head).toHaveProperty('description')
+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('Pages', () => {
+  it('renders the home page, data included', async () => {
+    const app = await createTestApp()
+
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/?name=Ada' }))
+
+    expect(response.statusCode).toBe(200)
+    // A page is a handler, so a rendered page is a response whose body is HTML. Query that HTML with
+    // whatever you already use (happy-dom, jsdom, Testing Library): none is bundled here.
+    expect(response.html()).toContain('Ada')
   })
 
-  it('should handle incoming events', () => {
-    // Arrange
-    const expectedMessage = 'Hello World!'
-    const event = { get: () => 'World' } as unknown as IncomingEvent
+  it('renders without a name', async () => {
+    const app = await createTestApp()
 
-    // Act
-    const response = app.handle(event) as { message: string }
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/' }))
 
-    // Assert
-    expect(response.message).toBe(expectedMessage)
-    expect(mockedLogger.info).toHaveBeenCalledWith(expectedMessage)
+    expect(response.statusCode).toBe(200)
   })
-
-  it('should render the message', () => {
-    // Arrange
-    const message = 'Hello World!'
-
-    // Act
-    const response = renderToString(app.render({ data: { message } } as any))
-
-    // Assert
-    expect(response).toContain(message)
-  })
-
-  it('should render the Stone.js logo', () => {
-    // Act
-    const response = renderToString(app.render({ data: { message: 'Hello World!' } } as any))
-
-    // Assert
-    expect(response).toContain('/logo.svg')
-    expect(response).toContain('alt="Stone.js"')
-    expect(response).toContain('Welcome to')
-    expect(response).toContain('Stone.js')
-  })
-
-  it('should get config', () => {
-    // Arrange
-    const config: any = AppConfig
-    const blueprint: any = { is: () => true, set: vi.fn() }
-
-    // Act
-    config.afterConfigure(blueprint)
-
-    // Assert
-    expect(blueprint.set).toHaveBeenCalled()
-  })
-})
+})

package/basic-service-declarative/app/Application.ts

@@ -1,5 +1,4 @@
 import { NodeHttp } from '@stone-js/node-http-adapter'
-import { NodeConsole } from '@stone-js/node-cli-adapter'
 import { IncomingEvent, IEventHandler, ILogger, LogLevel, StoneApp } from '@stone-js/core'
 
 /**
@@ -10,7 +9,6 @@ import { IncomingEvent, IEventHandler, ILogger, LogLevel, StoneApp } from '@ston
  * @NodeHttp() is used to enable the Node HTTP adapter.
  * @StoneApp() is used to enable the Stone application, it is required.
  */
-@NodeConsole()
 @NodeHttp({ default: true })
 @StoneApp({ logger: { level: LogLevel.INFO } })
 export class Application implements IEventHandler<IncomingEvent> {

package/basic-service-declarative/package.json

@@ -14,19 +14,19 @@
     "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/core": "^0.8.7",
-    "@stone-js/node-cli-adapter": "^0.8.7",
-    "@stone-js/node-http-adapter": "^0.8.7"
+    "@stone-js/core": "^0.8.9",
+    "@stone-js/node-http-adapter": "^0.8.9"
   },
   "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.7",
+    "@stone-js/cli": "^0.8.9",
+    "@stone-js/testing": "^0.8.9",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"

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

@@ -1,61 +1,28 @@
-import { Application } from '../app/Application'
-import { ILogger, IncomingEvent } from '@stone-js/core'
-
-// We must mock decorators to lighten the test environment
-vi.mock(import("@stone-js/core"), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    StoneApp: vi.fn(() => vi.fn()),
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock(import("@stone-js/node-cli-adapter"), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    NodeConsole: vi.fn(() => vi.fn()),
-  }
-})
-
-// We must mock decorators to lighten the test environment
-vi.mock(import("@stone-js/node-http-adapter"), async (importOriginal) => {
-  const actual = await importOriginal()
-  return {
-    ...actual,
-    NodeHttp: vi.fn(() => vi.fn()),
-  }
-})
-
+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', () => {
-  let app: Application
-  let mockedLogger: ILogger
+  it('answers the caller', async () => {
+    const app = await createTestApp()
 
-  beforeEach(() => {
-    mockedLogger = {
-      info: vi.fn(),
-    } as unknown as ILogger
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/?name=Ada' }))
 
-    app = new Application({ logger: mockedLogger })
+    expect(response.statusCode).toBe(200)
+    expect(response.json()).toMatchObject({ message: expect.stringContaining('Ada') })
   })
 
-  it('should create an application instance', () => {
-    // Assert
-    expect(app).toBeInstanceOf(Application)
-  })
+  it('answers when nobody says who they are', async () => {
+    const app = await createTestApp()
 
-  it('should handle incoming events', () => {
-    // Arrange
-    const expectedMessage = 'Hello World! Welcome to Stone.js.'
-    const event = { get: () => 'World' } as unknown as IncomingEvent
+    const response = await app.send(makeIncomingHttpEvent({ method: 'GET', url: '/' }))
 
-    // Act
-    const response = app.handle(event)
-
-    // Assert
-    expect(response.message).toBe(expectedMessage)
-    expect(response.framework.name).toBe('Stone.js')
-    expect(mockedLogger.info).toHaveBeenCalledWith(expectedMessage)
+    expect(response.statusCode).toBe(200)
   })
-})
+})

package/basic-service-imperative/app/Application.ts

@@ -1,6 +1,5 @@
 import { NODE_HTTP_PLATFORM, nodeHttpAdapterBlueprint } from '@stone-js/node-http-adapter'
-import { defineCommand, NODE_CONSOLE_PLATFORM, nodeConsoleAdapterBlueprint } from '@stone-js/node-cli-adapter'
-import { defineStoneApp, defineConfig, IBlueprint, ILogger, IncomingEvent, FunctionalEventHandler } from '@stone-js/core'
+import { defineStoneApp, ILogger, IncomingEvent, FunctionalEventHandler } from '@stone-js/core'
 
 /**
  * Create an handler using the factory handler.
@@ -40,20 +39,9 @@ export const Application = defineStoneApp(
     isFactory: true,
     adapter: { platform: NODE_HTTP_PLATFORM }
   },
-  [nodeHttpAdapterBlueprint, nodeConsoleAdapterBlueprint]
+  [nodeHttpAdapterBlueprint]
 )
 
-/**
- * Application configuration.
- */
-export const AppConfig = defineConfig({
-  afterConfigure (blueprint: IBlueprint) {
-    if (blueprint.is('stone.adapter.platform', NODE_CONSOLE_PLATFORM)) {
-      blueprint.set(defineCommand(FactoryHandler, { name: '*', isFactory: true }))
-    }
-  }
-})
-
 /**
  * Application options.
  */

package/basic-service-imperative/package.json

@@ -14,19 +14,19 @@
     "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/core": "^0.8.7",
-    "@stone-js/node-cli-adapter": "^0.8.7",
-    "@stone-js/node-http-adapter": "^0.8.7"
+    "@stone-js/core": "^0.8.9",
+    "@stone-js/node-http-adapter": "^0.8.9"
   },
   "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.7",
+    "@stone-js/cli": "^0.8.9",
+    "@stone-js/testing": "^0.8.9",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"