@stone-js/starters 0.8.3

package/standard-service-declarative/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "standard-service-declarative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's standard starter to create web app using declarative API.",
+  "author": "Mr. Stone <evensstone@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "stone dev",
+    "build": "stone build",
+    "preview": "stone preview dist/server.mjs",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "@stone-js/pipeline": "^0.8.3",
+    "@stone-js/http-core": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3",
+    "@stone-js/router": "^0.8.3",
+    "@stone-js/core": "^0.8.3"
+  },
+  "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.3",
+    "@types/node": "^24.0.7",
+    "@vitest/coverage-v8": "^3.0.9",
+    "vitest": "^3.0.9"
+  }
+}

package/standard-service-declarative/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "include": [
+    "app",
+    "tests",
+    ".stone",
+    "vitest.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ],
+  "compilerOptions": {
+    "strict": true,
+    "allowJs": false,
+    "target": "esnext",
+    "module": "ESNext",
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "types": ["node", "vitest/globals"],
+  }
+}

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

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vitest/config.js'
+
+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/standard-service-imperative/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Stone Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/standard-service-imperative/README.md

@@ -0,0 +1,39 @@
+# Stone.js - Standard starter
+
+Stone.js's standard starter to create web app using imperative API.
+
+## Project Setup
+
+```sh
+npm install
+```
+
+### Compile and Hot-Reload for Development
+
+```sh
+npm run dev
+```
+
+### Compile and Bundle for Production
+
+```sh
+npm run build
+```
+
+### Run the Production build
+
+```sh
+npm run preview
+```
+
+### Run tests
+
+```sh
+npm run test
+```
+
+### Run tests with coverage
+
+```sh
+npm run test:cvg
+```

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

@@ -0,0 +1,11 @@
+import { routerBlueprint } from '@stone-js/router'
+import { LogLevel, defineStoneApp } from '@stone-js/core'
+import { nodeHttpAdapterBlueprint } from '@stone-js/node-http-adapter'
+
+/**
+ * Define Stone Application.
+ */
+export const Application = defineStoneApp(
+  { name: 'MyApp', logger: { level: LogLevel.INFO } },
+  [routerBlueprint, nodeHttpAdapterBlueprint]
+)

package/standard-service-imperative/app/handlers/welcomeEventHandler.ts

@@ -0,0 +1,31 @@
+import { IncomingHttpEvent } from '@stone-js/http-core'
+import { WelcomeService } from '../services/welcomeService'
+import { defineRoute, FactoryEventHandler, FunctionalEventHandler } from '@stone-js/router'
+
+/**
+ * Welcome Event Handler Options
+*/
+export interface WelcomeEventHandlerOptions {
+  welcomeService: WelcomeService
+}
+
+/**
+ * Response data
+ */
+export interface ResponseData {
+  message: string
+}
+
+/**
+ * Welcome
+*/
+export const WelcomeEventHandler: FactoryEventHandler<IncomingHttpEvent> = (
+  { welcomeService }: WelcomeEventHandlerOptions
+): FunctionalEventHandler<IncomingHttpEvent> => (event: IncomingHttpEvent): ResponseData => {
+  return welcomeService.welcome(event.get<string>('name', 'World'))
+}
+
+/**
+ * WelcomeEventHandler Blueprint
+ */
+export const WelcomeEventHandlerBlueprint = defineRoute(WelcomeEventHandler, { path: '/:name?', isFactory: true })

package/standard-service-imperative/app/services/welcomeService.ts

@@ -0,0 +1,38 @@
+import { defineService, ILogger } from '@stone-js/core'
+
+/**
+ * Welcome Service Options
+*/
+export interface WelcomeServiceOptions {
+  logger: ILogger
+}
+
+/**
+ * Welcome Service Type
+ */
+export type WelcomeService = ReturnType<typeof WelcomeService>
+
+/**
+ * Welcome Service
+ */
+/* eslint-disable-next-line @typescript-eslint/no-redeclare */
+export const WelcomeService = ({ logger }: WelcomeServiceOptions): Record<PropertyKey, any> => ({
+  /**
+   * Welcome
+   *
+   * @param name - The name
+   * @returns A welcome message
+   */
+  welcome (name: string): { message: string } {
+    logger.info(`Welcome ${name}`)
+    return { message: `Hello ${name}!` }
+  }
+})
+
+/**
+ * Welcome Service Blueprint
+ */
+export const WelcomeServiceBlueprint = defineService(
+  WelcomeService,
+  { alias: 'welcomeService', isFactory: true }
+)

package/standard-service-imperative/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ts-basic-service-imperative",
+  "version": "1.0.0",
+  "description": "Stone.js's standard starter to create web app using imperative API.",
+  "author": "Mr. Stone <evensstone@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "stone dev",
+    "build": "stone build",
+    "preview": "stone preview dist/server.mjs",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "@stone-js/pipeline": "^0.8.3",
+    "@stone-js/http-core": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3",
+    "@stone-js/router": "^0.8.3",
+    "@stone-js/core": "^0.8.3"
+  },
+  "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.3",
+    "@types/node": "^24.0.7",
+    "@vitest/coverage-v8": "^3.0.9",
+    "vitest": "^3.0.9"
+  }
+}

package/standard-service-imperative/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "include": [
+    "app",
+    "tests",
+    ".stone",
+    "vitest.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ],
+  "compilerOptions": {
+    "strict": true,
+    "allowJs": false,
+    "target": "esnext",
+    "module": "ESNext",
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "types": ["node", "vitest/globals"],
+  }
+}

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

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vitest/config.js'
+
+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]
+      }
+    },
+  }
+});