create-simone-app 0.1.0

package/templates/api/base/src/data/users.json

@@ -0,0 +1,352 @@
+[
+  {
+    "id": "0d9b0fd3-2248-4649-9245-7c3890921ffc",
+    "name": "Nikita Crist",
+    "email": "nikita_crist44@gmail.com",
+    "role": "editor",
+    "createdAt": "2024-01-26T03:18:43.937Z"
+  },
+  {
+    "id": "2fcfe9e1-3056-44d5-8482-c1fc30dbbc15",
+    "name": "Major Lockman",
+    "email": "major_lockman33@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-08-25T17:00:58.001Z"
+  },
+  {
+    "id": "c8c78601-0a58-4e36-9c31-42ecadc2e8ce",
+    "name": "Stefan Ratke",
+    "email": "stefan.ratke@gmail.com",
+    "role": "viewer",
+    "createdAt": "2024-01-06T01:58:05.433Z"
+  },
+  {
+    "id": "58b5ff47-4409-4804-be32-7f3ac3b5aa81",
+    "name": "Darren Weissnat",
+    "email": "darren.weissnat@gmail.com",
+    "role": "viewer",
+    "createdAt": "2024-01-13T03:01:00.717Z"
+  },
+  {
+    "id": "e251ee4a-d883-41ee-8a55-beeca12e901a",
+    "name": "Lon Howe",
+    "email": "lon_howe@gmail.com",
+    "role": "admin",
+    "createdAt": "2025-06-04T14:28:19.422Z"
+  },
+  {
+    "id": "91543f6e-ac89-473b-940a-2ffe50e6ffd4",
+    "name": "Monique Oberbrunner",
+    "email": "monique.oberbrunner@yahoo.com",
+    "role": "viewer",
+    "createdAt": "2025-05-23T19:08:47.614Z"
+  },
+  {
+    "id": "ebbb54cc-de88-4cab-8ce5-6190784900d5",
+    "name": "Kristopher Leannon",
+    "email": "kristopher_leannon@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-02-07T18:42:14.766Z"
+  },
+  {
+    "id": "c4710fdb-6224-48ba-94fb-89635c0100db",
+    "name": "Levi Larson-Hand",
+    "email": "levi.larson-hand47@gmail.com",
+    "role": "editor",
+    "createdAt": "2024-10-18T07:22:01.018Z"
+  },
+  {
+    "id": "da21a09f-96a7-48f6-afe3-1101a15d0d41",
+    "name": "Andres Kuvalis",
+    "email": "andres_kuvalis@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-05-09T16:59:57.504Z"
+  },
+  {
+    "id": "5ed6cc1e-8d5e-460e-815f-f9a745accc17",
+    "name": "Wyman Sanford",
+    "email": "wyman.sanford88@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-04-14T12:38:45.708Z"
+  },
+  {
+    "id": "db11f55d-ffc6-41c8-b6e1-707011ab9f54",
+    "name": "Braeden Bins",
+    "email": "braeden_bins@gmail.com",
+    "role": "admin",
+    "createdAt": "2025-10-13T10:12:52.341Z"
+  },
+  {
+    "id": "b7a9e04f-e794-4375-991f-fb84da2edfb9",
+    "name": "Arlie Ledner-Murphy",
+    "email": "arlie_ledner-murphy4@yahoo.com",
+    "role": "editor",
+    "createdAt": "2025-08-15T12:20:50.677Z"
+  },
+  {
+    "id": "7640ddff-8cfd-4372-9f93-a951a8c8d88e",
+    "name": "Kenton Spinka-Smitham",
+    "email": "kenton.spinka-smitham@gmail.com",
+    "role": "viewer",
+    "createdAt": "2024-06-04T16:14:35.485Z"
+  },
+  {
+    "id": "e58c69df-2e74-47f7-85a3-12222a25e7a2",
+    "name": "Flo Kertzmann",
+    "email": "flo.kertzmann27@gmail.com",
+    "role": "admin",
+    "createdAt": "2024-03-29T04:26:08.480Z"
+  },
+  {
+    "id": "ca1de04c-b235-4795-97b0-4be881783460",
+    "name": "Georgette Batz",
+    "email": "georgette.batz@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-05-11T10:10:15.235Z"
+  },
+  {
+    "id": "6245a95f-9312-4322-b42e-186f16fdd42a",
+    "name": "Bernie Rodriguez",
+    "email": "bernie_rodriguez@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-08-24T14:37:42.361Z"
+  },
+  {
+    "id": "92780521-f5c4-4ac9-b765-edf1bf21b9d2",
+    "name": "Delaney Green",
+    "email": "delaney.green@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-01-17T08:39:34.801Z"
+  },
+  {
+    "id": "74b83e68-e91f-4a52-8c98-ec243b09ce5d",
+    "name": "Hattie Hodkiewicz",
+    "email": "hattie.hodkiewicz@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-06-16T13:59:11.091Z"
+  },
+  {
+    "id": "52e967f2-9890-4de9-bbeb-2996bee71fd1",
+    "name": "Linwood Fritsch",
+    "email": "linwood_fritsch59@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-09-02T00:42:01.131Z"
+  },
+  {
+    "id": "55b73722-76e5-49a0-8a2f-261f891b3e33",
+    "name": "Ernest Waelchi",
+    "email": "ernest_waelchi@hotmail.com",
+    "role": "editor",
+    "createdAt": "2025-01-18T07:54:09.862Z"
+  },
+  {
+    "id": "f54a602b-a033-4a01-8c2a-313bdd6a34e0",
+    "name": "Larissa Stoltenberg",
+    "email": "larissa.stoltenberg@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-10-14T13:01:56.105Z"
+  },
+  {
+    "id": "96864fc2-d7ec-4604-a8a4-2df8240e1948",
+    "name": "Devonte Gleichner",
+    "email": "devonte.gleichner1@yahoo.com",
+    "role": "viewer",
+    "createdAt": "2025-09-30T19:31:38.201Z"
+  },
+  {
+    "id": "6802b193-645b-4497-9aeb-30490795c11b",
+    "name": "Manuel Johnston",
+    "email": "manuel.johnston@yahoo.com",
+    "role": "viewer",
+    "createdAt": "2025-05-22T19:45:16.890Z"
+  },
+  {
+    "id": "f728dbca-bd37-43ff-90be-29e0b4eff7dd",
+    "name": "Gayle Collins",
+    "email": "gayle.collins59@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-02-26T06:04:01.012Z"
+  },
+  {
+    "id": "c5ae930d-0d8f-4cf5-8c67-adfc66b31544",
+    "name": "Nathen Lindgren",
+    "email": "nathen.lindgren98@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-05-11T19:43:54.260Z"
+  },
+  {
+    "id": "f792f3fa-9832-432c-a50f-eef26cb2d338",
+    "name": "Payton Thiel",
+    "email": "payton.thiel87@hotmail.com",
+    "role": "admin",
+    "createdAt": "2025-10-11T16:11:45.839Z"
+  },
+  {
+    "id": "654b713a-1d77-49d5-ba94-ecaddbdba9c2",
+    "name": "Reinhold Bogisich",
+    "email": "reinhold.bogisich82@yahoo.com",
+    "role": "editor",
+    "createdAt": "2025-06-27T12:06:31.111Z"
+  },
+  {
+    "id": "9fa4a8c1-c8f5-4ae1-beb1-4b19590dffb2",
+    "name": "Rhoda Grant",
+    "email": "rhoda.grant32@gmail.com",
+    "role": "viewer",
+    "createdAt": "2025-05-14T11:44:02.031Z"
+  },
+  {
+    "id": "cb31aa4f-26f6-4a64-bf6e-330a5d7f2dcc",
+    "name": "Zoie Cruickshank",
+    "email": "zoie_cruickshank13@yahoo.com",
+    "role": "viewer",
+    "createdAt": "2025-03-26T18:30:46.608Z"
+  },
+  {
+    "id": "37194c47-0167-494b-8dc0-713f279b8058",
+    "name": "Broderick Keeling",
+    "email": "broderick.keeling7@hotmail.com",
+    "role": "admin",
+    "createdAt": "2025-02-18T20:56:11.343Z"
+  },
+  {
+    "id": "b0e08bdb-c5d1-4e8d-97a8-b1032d3f52ca",
+    "name": "Curtis Nienow",
+    "email": "curtis_nienow@hotmail.com",
+    "role": "viewer",
+    "createdAt": "2025-04-20T09:18:49.178Z"
+  },
+  {
+    "id": "dbb655f0-d97b-47de-b649-e39ab2be23f2",
+    "name": "Angelina Koepp",
+    "email": "angelina.koepp87@hotmail.com",
+    "role": "editor",
+    "createdAt": "2024-09-19T14:23:24.479Z"
+  },
+  {
+    "id": "5c2f7312-85d6-439b-b220-ba7dc9d31408",
+    "name": "Gennaro O'Reilly",
+    "email": "gennaro.oreilly@gmail.com",
+    "role": "admin",
+    "createdAt": "2025-01-05T18:55:38.434Z"
+  },
+  {
+    "id": "ad787a20-4b3a-4f1a-87d2-bdfa79d90eba",
+    "name": "Yazmin Wilderman",
+    "email": "yazmin.wilderman65@hotmail.com",
+    "role": "editor",
+    "createdAt": "2025-12-31T13:42:50.859Z"
+  },
+  {
+    "id": "be65accc-6d18-4055-96b6-735319a976d8",
+    "name": "Jalyn Mante",
+    "email": "jalyn.mante38@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-01-25T01:31:22.554Z"
+  },
+  {
+    "id": "0ae3e0e5-1744-44c8-949b-4612a28b194f",
+    "name": "Rex Auer-Dietrich",
+    "email": "rex_auer-dietrich@yahoo.com",
+    "role": "viewer",
+    "createdAt": "2025-03-15T18:40:39.380Z"
+  },
+  {
+    "id": "de53c4d6-a197-492b-9d31-0a983697f2b6",
+    "name": "Dallas Jenkins",
+    "email": "dallas_jenkins99@yahoo.com",
+    "role": "admin",
+    "createdAt": "2025-06-13T11:48:00.024Z"
+  },
+  {
+    "id": "535181c3-8ea8-455a-9fa8-b708f2b3817c",
+    "name": "Ben Dicki",
+    "email": "ben_dicki92@hotmail.com",
+    "role": "editor",
+    "createdAt": "2024-04-21T09:59:11.384Z"
+  },
+  {
+    "id": "1c2dcb04-451e-4846-b798-e7fd3e1d6edc",
+    "name": "Kris Mueller",
+    "email": "kris.mueller40@gmail.com",
+    "role": "viewer",
+    "createdAt": "2024-09-09T23:58:24.622Z"
+  },
+  {
+    "id": "79c28625-102f-48f6-a487-1a39a20c70f0",
+    "name": "Rigoberto Walker",
+    "email": "rigoberto.walker14@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-03-14T20:44:51.649Z"
+  },
+  {
+    "id": "49862e73-56db-4c06-9704-c28303fcf718",
+    "name": "Jayce Morar",
+    "email": "jayce.morar48@yahoo.com",
+    "role": "admin",
+    "createdAt": "2025-06-23T00:11:32.499Z"
+  },
+  {
+    "id": "fc5b74d0-e7aa-4ea9-9182-b8a01b110fb5",
+    "name": "Haylie Toy",
+    "email": "haylie_toy66@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-03-12T22:15:11.704Z"
+  },
+  {
+    "id": "4c96319c-a80f-4c4f-899b-ca25e35679f3",
+    "name": "Dimitri Wisoky",
+    "email": "dimitri_wisoky64@gmail.com",
+    "role": "viewer",
+    "createdAt": "2025-09-21T15:52:29.917Z"
+  },
+  {
+    "id": "bca28fe0-22bd-438d-bb89-849bdac2703b",
+    "name": "Delta Spinka",
+    "email": "delta.spinka80@gmail.com",
+    "role": "editor",
+    "createdAt": "2025-06-19T21:00:09.410Z"
+  },
+  {
+    "id": "c0b3f552-4ef5-47be-a966-b095c197a198",
+    "name": "Fidel Abshire",
+    "email": "fidel_abshire80@hotmail.com",
+    "role": "viewer",
+    "createdAt": "2024-12-30T05:23:51.184Z"
+  },
+  {
+    "id": "87256139-bfea-46ac-b16d-69925500d484",
+    "name": "Eva Schamberger",
+    "email": "eva.schamberger@gmail.com",
+    "role": "admin",
+    "createdAt": "2025-08-09T17:34:26.415Z"
+  },
+  {
+    "id": "6bc292ca-f104-443e-834c-7c1701e2865e",
+    "name": "Bianka Kunze",
+    "email": "bianka_kunze@hotmail.com",
+    "role": "admin",
+    "createdAt": "2024-11-02T03:18:35.545Z"
+  },
+  {
+    "id": "97f95123-4d88-41db-a1b8-1772fda76a80",
+    "name": "Willow Donnelly",
+    "email": "willow.donnelly@yahoo.com",
+    "role": "admin",
+    "createdAt": "2024-07-08T01:14:37.879Z"
+  },
+  {
+    "id": "ed37fc01-7e87-41ad-b6cf-384c9ac6e82b",
+    "name": "Nadine Thiel",
+    "email": "nadine_thiel90@gmail.com",
+    "role": "viewer",
+    "createdAt": "2024-04-12T20:38:34.832Z"
+  },
+  {
+    "id": "91ec8f6f-aa2e-4620-988b-e1b2dd8b57d7",
+    "name": "Sibyl Kiehn",
+    "email": "sibyl_kiehn33@hotmail.com",
+    "role": "viewer",
+    "createdAt": "2025-08-26T18:57:41.524Z"
+  }
+]

package/templates/api/base/src/lib/appName.ts

@@ -0,0 +1,2 @@
+/** Project name, substituted once by create-simone-app. Use in template strings so line width never depends on it. */
+export const APP_NAME = '__NAME__'

package/templates/api/base/src/lib/http-error.ts

@@ -0,0 +1,14 @@
+/** Error carrying an HTTP status; errorHandler turns it into `{ error, details }`. */
+export class HttpError extends Error {
+  constructor(
+    readonly status: number,
+    message: string,
+    readonly details?: unknown,
+  ) {
+    super(message)
+    this.name = 'HttpError'
+  }
+}
+
+export const notFound = (resource: string, id: string): HttpError =>
+  new HttpError(404, `${resource} ${id} not found`)

package/templates/api/base/src/lib/pagination.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod'
+
+export const MAX_LIMIT = 100
+
+/** Shared list contract: `{ data, page, limit, total }` — the FE table relies on it. */
+export interface Page<T> {
+  data: T[]
+  page: number
+  limit: number
+  total: number
+}
+
+export const PaginationQuerySchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  limit: z.coerce.number().int().min(1).max(MAX_LIMIT).default(20),
+})
+export type PaginationQuery = z.infer<typeof PaginationQuerySchema>
+
+/** `sort=name` ascending, `sort=-name` descending; only whitelisted fields. */
+export const sortSchema = <const F extends readonly [string, ...string[]]>(
+  fields: F,
+) =>
+  z
+    .string()
+    .regex(
+      new RegExp(`^-?(${fields.join('|')})$`),
+      `sort must be one of ${fields.join(', ')} (prefix - for desc)`,
+    )
+    .optional()
+
+export const paginate = <T>(
+  rows: readonly T[],
+  { page, limit }: PaginationQuery,
+): Page<T> => ({
+  data: rows.slice((page - 1) * limit, page * limit),
+  page,
+  limit,
+  total: rows.length,
+})
+
+export const applySort = <T extends object>(
+  rows: readonly T[],
+  sort: string | undefined,
+): T[] => {
+  if (!sort) return [...rows]
+  const desc = sort.startsWith('-')
+  const field = (desc ? sort.slice(1) : sort) as keyof T
+  const dir = desc ? -1 : 1
+  return [...rows].sort((a, b) => {
+    const x = a[field]
+    const y = b[field]
+    if (typeof x === 'number' && typeof y === 'number') return (x - y) * dir
+    return String(x).localeCompare(String(y)) * dir
+  })
+}

package/templates/api/base/src/modules/orders/orders.repository.ts

@@ -0,0 +1,26 @@
+import {
+  ordersRepository,
+  productsRepository,
+  usersRepository,
+} from '../../data/repository'
+import { notFound } from '../../lib/http-error'
+import type { CreateOrderBody, Order } from './orders.schema'
+
+const money = (n: number): number => Math.round(n * 100) / 100
+
+/** Resolves prices server-side; throws 404 for unknown user/product. */
+export const createOrder = ({ userId, items }: CreateOrderBody): Order => {
+  if (!usersRepository.findById(userId)) throw notFound('User', userId)
+  const priced = items.map(({ productId, qty }) => {
+    const product = productsRepository.findById(productId)
+    if (!product) throw notFound('Product', productId)
+    return { productId, qty, unitPrice: product.price }
+  })
+  return ordersRepository.insert({
+    id: crypto.randomUUID(),
+    userId,
+    items: priced,
+    total: money(priced.reduce((sum, i) => sum + i.qty * i.unitPrice, 0)),
+    createdAt: new Date().toISOString(),
+  })
+}

package/templates/api/base/src/modules/orders/orders.schema.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod'
+
+export { OrderSchema, type Order } from '../../data/schemas'
+
+export const CreateOrderBodySchema = z.object({
+  userId: z.string().min(1),
+  items: z
+    .array(z.object({ productId: z.string().min(1), qty: z.int().min(1) }))
+    .min(1),
+})
+export type CreateOrderBody = z.infer<typeof CreateOrderBodySchema>

package/templates/api/base/src/modules/products/products.repository.ts

@@ -0,0 +1,17 @@
+import { productsRepository } from '../../data/repository'
+import { type Page, applySort, paginate } from '../../lib/pagination'
+import type { Product, ProductsQuery } from './products.schema'
+
+export const searchProducts = ({
+  category,
+  sort,
+  page,
+  limit,
+}: ProductsQuery): Page<Product> => {
+  const all = productsRepository.all()
+  const filtered = category ? all.filter((p) => p.category === category) : all
+  return paginate(applySort(filtered, sort), { page, limit })
+}
+
+export const findProduct = (id: string): Product | undefined =>
+  productsRepository.findById(id)

package/templates/api/base/src/modules/products/products.schema.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod'
+
+import { PRODUCT_CATEGORIES } from '../../data/schemas'
+import { PaginationQuerySchema, sortSchema } from '../../lib/pagination'
+
+export { ProductSchema, type Product } from '../../data/schemas'
+
+export const PRODUCT_SORT_FIELDS = [
+  'name',
+  'category',
+  'price',
+  'stock',
+] as const
+
+export const ProductsQuerySchema = PaginationQuerySchema.extend({
+  category: z.enum(PRODUCT_CATEGORIES).optional(),
+  sort: sortSchema(PRODUCT_SORT_FIELDS),
+})
+export type ProductsQuery = z.infer<typeof ProductsQuerySchema>
+
+export const ProductIdParamsSchema = z.object({ id: z.string().min(1) })

package/templates/api/base/src/modules/stats/stats.repository.ts

@@ -0,0 +1,37 @@
+import {
+  ordersRepository,
+  productsRepository,
+  usersRepository,
+} from '../../data/repository'
+
+export interface Stats {
+  users: number
+  products: number
+  orders: number
+  revenue: number
+  topCategory: string | null
+}
+
+export const computeStats = (): Stats => {
+  const orders = ordersRepository.all()
+  const revenueByCategory = new Map<string, number>()
+  for (const order of orders) {
+    for (const item of order.items) {
+      const category =
+        productsRepository.findById(item.productId)?.category ?? 'unknown'
+      revenueByCategory.set(
+        category,
+        (revenueByCategory.get(category) ?? 0) + item.qty * item.unitPrice,
+      )
+    }
+  }
+  const top = [...revenueByCategory.entries()].sort((a, b) => b[1] - a[1])[0]
+  return {
+    users: usersRepository.all().length,
+    products: productsRepository.all().length,
+    orders: orders.length,
+    revenue:
+      Math.round(orders.reduce((sum, o) => sum + o.total, 0) * 100) / 100,
+    topCategory: top?.[0] ?? null,
+  }
+}

package/templates/api/base/src/modules/users/users.repository.ts

@@ -0,0 +1,26 @@
+import { usersRepository } from '../../data/repository'
+import { type Page, applySort, paginate } from '../../lib/pagination'
+import type { User, UsersQuery } from './users.schema'
+
+const matches = (user: User, q: string): boolean => {
+  const needle = q.toLowerCase()
+  return (
+    user.name.toLowerCase().includes(needle) ||
+    user.email.toLowerCase().includes(needle)
+  )
+}
+
+export const searchUsers = ({
+  q,
+  sort,
+  page,
+  limit,
+}: UsersQuery): Page<User> => {
+  const filtered = q
+    ? usersRepository.all().filter((u) => matches(u, q))
+    : usersRepository.all()
+  return paginate(applySort(filtered, sort), { page, limit })
+}
+
+export const findUser = (id: string): User | undefined =>
+  usersRepository.findById(id)

package/templates/api/base/src/modules/users/users.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod'
+
+import { PaginationQuerySchema, sortSchema } from '../../lib/pagination'
+
+export { UserSchema, type User } from '../../data/schemas'
+
+export const USER_SORT_FIELDS = ['name', 'email', 'role', 'createdAt'] as const
+
+export const UsersQuerySchema = PaginationQuerySchema.extend({
+  q: z.string().trim().min(1).optional(),
+  sort: sortSchema(USER_SORT_FIELDS),
+})
+export type UsersQuery = z.infer<typeof UsersQuerySchema>
+
+export const UserIdParamsSchema = z.object({ id: z.string().min(1) })

package/templates/api/base/test/docs.test.ts

@@ -0,0 +1,23 @@
+import request from 'supertest'
+import { describe, expect, it } from 'vitest'
+
+import { createApp } from '../src/app'
+
+describe('GET /docs.json', () => {
+  it('serves the parsed openapi.yaml with all 7 paths', async () => {
+    const res = await request(createApp()).get('/docs.json')
+    expect(res.status).toBe(200)
+    expect(res.body.openapi).toBe('3.1.0')
+    expect(Object.keys(res.body.paths).sort()).toEqual(
+      [
+        '/api/health',
+        '/api/users',
+        '/api/users/{id}',
+        '/api/products',
+        '/api/products/{id}',
+        '/api/orders',
+        '/api/stats',
+      ].sort(),
+    )
+  })
+})

package/templates/api/base/test/health.test.ts

@@ -0,0 +1,19 @@
+import request from 'supertest'
+import { describe, expect, it } from 'vitest'
+
+import { createApp } from '../src/app'
+
+describe('GET /api/health', () => {
+  it('returns ok', async () => {
+    const res = await request(createApp()).get('/api/health')
+    expect(res.status).toBe(200)
+    expect(res.body.status).toBe('ok')
+    expect(typeof res.body.uptime).toBe('number')
+  })
+
+  it('unknown route → 404 with stable shape', async () => {
+    const res = await request(createApp()).get('/nope')
+    expect(res.status).toBe(404)
+    expect(res.body).toEqual({ error: 'Route GET /nope not found' })
+  })
+})