first commit

Author: spaceo

.gitignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.data
+.nitro
+.cache
+.output
+.env
+.env.local

README.md

@@ -0,0 +1,4 @@
+# Nitro starter
+
+Look at the [nitro quick start](https://nitro.build/guide#quick-start) to learn more how to get started.
+# nitro-models-validation-and-transformation-Public

cat/cat.repository.ts

@@ -0,0 +1,40 @@
+import { CatRemote } from "./models/cat.remote";
+
+export class CatsRepository {
+  private cats: CatRemote[];
+
+  constructor() {
+    this.cats = [
+      {
+        id: 1,
+        name: "Whiskers",
+        age: 18,
+        breed: "Siamese",
+      },
+      {
+        id: 2,
+        name: "Fluffy",
+        age: 6,
+        breed: "Persian",
+      },
+      {
+        id: 3,
+        name: "Mittens",
+        age: 1,
+        breed: "Maine Coon",
+      },
+      {
+        id: 4,
+        name: "Tigger",
+        age: 19,
+        breed: "Ragdoll",
+      },
+    ];
+  }
+
+  async getById(id: number) {
+    const cat = this.cats.find((cat) => cat.id === id);
+    if (!cat) throw new Error("Cat not found");
+    return CatRemote.create(cat);
+  }
+}

cat/controllers/cat.controller.ts

@@ -0,0 +1,14 @@
+import { CatsRepository } from "../cat.repository";
+import { CatService } from "../services/cat.service";
+
+export class CatController {
+  private catService: CatService;
+
+  constructor() {
+    this.catService = new CatService(new CatsRepository());
+  }
+
+  async getById(id: number) {
+    return this.catService.getCat(id);
+  }
+}

cat/models/cat.local.ts

@@ -0,0 +1,24 @@
+import z from "zod";
+
+// The local model for the Cat entity used internally.
+// You could argue whether this model is needed at all, since it replicates the remote model.
+export class CatLocal {
+  public static readonly schema = z.object({
+    id: z.number(),
+    name: z.string(),
+    age: z.number(),
+    breed: z.string(),
+  });
+
+  constructor(
+    public id: number,
+    public name: string,
+    public age: number,
+    public breed: string,
+  ) {}
+
+  public static create<TData>(data: TData) {
+    const { id, name, age, breed } = this.schema.parse(data);
+    return new this(id, name, age, breed);
+  }
+}

cat/models/cat.remote.ts

@@ -0,0 +1,23 @@
+import z from "zod";
+
+// The remote model for the Cat returned by the remote source.
+export class CatRemote {
+  public static readonly schema = z.object({
+    id: z.number(),
+    name: z.string(),
+    age: z.number(),
+    breed: z.string(),
+  });
+
+  constructor(
+    public id: number,
+    public name: string,
+    public age: number,
+    public breed: string,
+  ) {}
+
+  public static create<TData>(data: TData) {
+    const { id, name, age, breed } = this.schema.parse(data);
+    return new this(id, name, age, breed);
+  }
+}

cat/models/cat.ts

@@ -0,0 +1,37 @@
+import z from "zod";
+
+type AgeCategory = "Kitten" | "Adult" | "Senior";
+
+// The Cat is the representation of a Cat to send to client.
+export class Cat {
+  public static readonly schema = z.object({
+    name: z.string(),
+    age: z.number(),
+    breed: z.string(),
+  });
+
+  constructor(
+    public name: string,
+    public ageCategory: AgeCategory,
+    public breed: string,
+  ) {}
+
+  private static getageCategory(age: number): AgeCategory {
+    if (age < 1) return "Kitten";
+    if (age < 7) return "Adult";
+    return "Senior";
+  }
+
+  // The client is not interested in the age but in the age category.
+  // The client is also not interested in the id of the cat -
+  // that is why the is is not part of the constructor.
+  // Also neither the id nor the age is returned in the `transform` function.
+  public static create<TData>(data: TData) {
+    const { name, ageCategory, breed } = this.schema
+      .transform(({ name, age, breed }) => {
+        return { name, ageCategory: this.getageCategory(age), breed };
+      })
+      .parse(data);
+    return new this(name, ageCategory, breed);
+  }
+}

cat/services/cat.service.ts

@@ -0,0 +1,18 @@
+import { CatLocal } from "cat/models/cat.local";
+import { CatsRepository } from "../cat.repository";
+import { Cat } from "cat/models/cat";
+
+export class CatService {
+  constructor(private repository: CatsRepository) {}
+
+  async getLocalCat(id: number) {
+    const remoteCat = await this.repository.getById(id);
+    if (!remoteCat) throw new Error("Cat not found");
+    return CatLocal.create(remoteCat);
+  }
+
+  async getCat(id: number) {
+    const localCat = await this.getLocalCat(id);
+    return Cat.create(localCat);
+  }
+}

nitro.config.ts

@@ -0,0 +1,15 @@
+import { defineNitroConfig } from "nitropack/config";
+import { fileURLToPath } from "url";
+import { resolve, dirname } from "path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// https://nitro.build/config
+export default defineNitroConfig({
+  compatibilityDate: "latest",
+  srcDir: "server",
+  imports: false,
+  alias: {
+    cat: resolve(__dirname, "cat"),
+  },
+});

package.json

@@ -0,0 +1,17 @@
+{
+  "name": "nitro-app",
+  "private": true,
+  "scripts": {
+    "build": "nitro build",
+    "dev": "nitro dev",
+    "preview": "node .output/server/index.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "h3": "^1.15.4",
+    "nitropack": "^2.12.4"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  }
+}