create-nexwire 4.0.0 → 4.1.1

package/hono/src/framework/maker-cli/stubs/notification/route.api.ts.stub

@@ -1,50 +1,50 @@
-import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
-import { authMiddleware } from "@/middlewares/auth-middleware.js";
-import { list, unreadCount, markRead, markAllRead, remove } from "../controllers/{{module}}.controller.js";
-import { PaginatedNotificationsSchema, UnreadCountSchema } from "../controllers/{{module}}.schema.js";
-
-const listRoute = createRoute({
-  path: "/",
-  method: "get",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(PaginatedNotificationsSchema, "Paginated notifications") },
-});
-
-const unreadCountRoute = createRoute({
-  path: "/unread-count",
-  method: "get",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(UnreadCountSchema, "Unread count") },
-});
-
-const markReadRoute = createRoute({
-  path: "/{id}/read",
-  method: "patch",
-  tags: ["Notifications"],
-  request: { params: z.object({ id: z.coerce.number() }) },
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Marked as read") },
-});
-
-const markAllReadRoute = createRoute({
-  path: "/read-all",
-  method: "patch",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "All marked as read") },
-});
-
-const deleteRoute = createRoute({
-  path: "/{id}",
-  method: "delete",
-  tags: ["Notifications"],
-  request: { params: z.object({ id: z.coerce.number() }) },
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Deleted") },
-});
-
-export default createRouter()
-  .group(authMiddleware)
-  .api(listRoute, list)
-  .api(unreadCountRoute, unreadCount)
-  .api(markReadRoute, markRead)
-  .api(markAllReadRoute, markAllRead)
-  .api(deleteRoute, remove);
+import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { list, markAllRead, markRead, remove, unreadCount } from "../controllers/{{module}}.js";
+import { PaginatedNotificationsSchema, UnreadCountSchema } from "../schemas/{{module}}.js";
+
+const listRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(PaginatedNotificationsSchema, "Paginated notifications") },
+});
+
+const unreadCountRoute = createRoute({
+  path: "/unread-count",
+  method: "get",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(UnreadCountSchema, "Unread count") },
+});
+
+const markReadRoute = createRoute({
+  path: "/{id}/read",
+  method: "patch",
+  tags: ["Notifications"],
+  request: { params: z.object({ id: z.coerce.number() }) },
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Marked as read") },
+});
+
+const markAllReadRoute = createRoute({
+  path: "/read-all",
+  method: "patch",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "All marked as read") },
+});
+
+const deleteRoute = createRoute({
+  path: "/{id}",
+  method: "delete",
+  tags: ["Notifications"],
+  request: { params: z.object({ id: z.coerce.number() }) },
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Deleted") },
+});
+
+export default createRouter()
+  .group(authMiddleware)
+  .api(listRoute, list)
+  .api(unreadCountRoute, unreadCount)
+  .api(markReadRoute, markRead)
+  .api(markAllReadRoute, markAllRead)
+  .api(deleteRoute, remove);
 

package/hono/src/framework/maker-cli/stubs/notification/route.plain.ts.stub

@@ -1,12 +1,12 @@
-import { group } from "@/framework/facade.js";
-import { authMiddleware } from "@/middlewares/auth-middleware.js";
-import { list, unreadCount, markRead, markAllRead, remove } from "../controllers/{{module}}.controller.js";
-
-export default group()
-  .use(authMiddleware)
-  .get("/", list)
-  .get("/unread-count", unreadCount)
-  .patch("/:id/read", markRead)
-  .patch("/read-all", markAllRead)
-  .delete("/:id", remove);
+import { group } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { list, unreadCount, markRead, markAllRead, remove } from "../controllers/{{module}}.js";
+
+export default group()
+  .use(authMiddleware)
+  .get("/", list)
+  .get("/unread-count", unreadCount)
+  .patch("/:id/read", markRead)
+  .patch("/read-all", markAllRead)
+  .delete("/:id", remove);
 

package/hono/src/framework/maker-cli/stubs/route/api.ts.stub

@@ -1,80 +1,94 @@
-import { createRoute, group, HttpStatusCodes, jsonContent } from "@/framework/facade.js";
-import { requireRole } from "@/middlewares/role-middleware.js";
-import { destroy, index, show, store, update } from "@/modules/{{module}}/controllers/{{controller}}.controller.js";
-import {
-  Create{{ClassName}}Schema,
-  {{ClassName}}IdParamsSchema,
-  {{ClassName}}ListResponseSchema,
-  {{ClassName}}MessageSchema,
-  {{ClassName}}ResponseSchema,
-  Update{{ClassName}}Schema
-} from "@/modules/{{module}}/controllers/{{controller}}.schema.js";
-
-const indexRoute = createRoute({
-  path: "/",
-  method: "get",
-  tags: ["{{ModuleClass}}"],
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ListResponseSchema, "{{module}} list")
-  }
-});
-
-const showRoute = createRoute({
-  path: "/{id}",
-  method: "get",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ResponseSchema, "{{module}} item"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-const storeRoute = createRoute({
-  path: "/",
-  method: "post",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    body: jsonContent(Create{{ClassName}}Schema, "Create {{module}} payload")
-  },
-  responses: {
-    [HttpStatusCodes.CREATED]: jsonContent({{ClassName}}MessageSchema, "Created")
-  }
-});
-
-const updateRoute = createRoute({
-  path: "/{id}",
-  method: "put",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema,
-    body: jsonContent(Update{{ClassName}}Schema, "Update {{module}} payload")
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Updated"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-const destroyRoute = createRoute({
-  path: "/{id}",
-  method: "delete",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Deleted"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-export default group()
-  .api(indexRoute, index)
-  .api(showRoute, show)
-  .api(storeRoute, store)
-  .api(updateRoute, update)
-  .api(destroyRoute, destroy);
+import { createRoute, group, HttpStatusCodes, jsonContent } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+import { destroy, index, show, store, update } from "@/modules/{{module}}/controllers/{{controller}}.js";
+import {
+  Create{{ClassName}}Schema,
+  {{ClassName}}IdParamsSchema,
+  {{ClassName}}ListResponseSchema,
+  {{ClassName}}MessageSchema,
+  {{ClassName}}ResponseSchema,
+  Update{{ClassName}}Schema
+} from "@/modules/{{module}}/schemas/{{controller}}.js";
+
+const indexRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ListResponseSchema, "{{module}} list")
+  }
+});
+
+const showRoute = createRoute({
+  path: "/{id}",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ResponseSchema, "{{module}} item"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+const storeRoute = createRoute({
+  path: "/",
+  method: "post",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    body: jsonContent(Create{{ClassName}}Schema, "Create {{module}} payload")
+  },
+  responses: {
+    [HttpStatusCodes.CREATED]: jsonContent({{ClassName}}MessageSchema, "Created")
+  }
+});
+
+const updateRoute = createRoute({
+  path: "/{id}",
+  method: "put",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema,
+    body: jsonContent(Update{{ClassName}}Schema, "Update {{module}} payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Updated"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+const destroyRoute = createRoute({
+  path: "/{id}",
+  method: "delete",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Deleted"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+export default group()
+  .api(indexRoute, index)
+  .api(showRoute, show)
+  .api(storeRoute, store)
+  .api(updateRoute, update)
+  .api(destroyRoute, destroy);
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.
 

package/hono/src/framework/maker-cli/stubs/route/plain.ts.stub

@@ -1,11 +1,24 @@
-import { group } from "@/framework/facade.js";
-import { requireRole } from "@/middlewares/role-middleware.js";
-import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.controller.js";
-
-export default group()
-  .get("/", index)
-  .get("/:id", show)
-  .post("/", store)
-  .put("/:id", update)
-  .delete("/:id", destroy);
+import { group } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.js";
 
+export default group()
+  .get("/", index)
+  .get("/:id", show)
+  .post("/", store)
+  .put("/:id", update)
+  .delete("/:id", destroy);
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.

package/hono/src/framework/maker-cli/stubs/route/standalone.api.ts.stub

@@ -0,0 +1,112 @@
+import { createRoute, group, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+
+/**
+ * {{module}} routes for {{controller}}.
+ *
+ * Wire each route to a handler:
+ *   import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.js";
+ *   export default group().api(indexRoute, index).api(showRoute, show) ...
+ *
+ * Wire each route to its validation schema:
+ *   import {
+ *     Create{{ClassName}}Schema,
+ *     {{ClassName}}IdParamsSchema,
+ *     {{ClassName}}ListResponseSchema,
+ *     {{ClassName}}MessageSchema,
+ *     {{ClassName}}ResponseSchema,
+ *     Update{{ClassName}}Schema
+ *   } from "@/modules/{{module}}/schemas/{{controller}}.js";
+ */
+
+const indexRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  // request: {
+  //   query: {{ClassName}}ListQuerySchema
+  // },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({ message: z.string(), data: z.array(z.object({ id: z.number(), name: z.string() })) }),
+      "{{module}} list"
+    )
+  }
+});
+
+const showRoute = createRoute({
+  path: "/{id}",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  // request: {
+  //   params: {{ClassName}}IdParamsSchema
+  // },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({ message: z.string(), data: z.object({ id: z.number(), name: z.string() }) }),
+      "{{module}} item"
+    ),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Not found")
+  }
+});
+
+const storeRoute = createRoute({
+  path: "/",
+  method: "post",
+  tags: ["{{ModuleClass}}"],
+  // request: {
+  //   body: jsonContent(Create{{ClassName}}Schema, "Create {{module}} payload")
+  // },
+  responses: {
+    [HttpStatusCodes.CREATED]: jsonContent(z.object({ message: z.string() }), "Created")
+  }
+});
+
+const updateRoute = createRoute({
+  path: "/{id}",
+  method: "put",
+  tags: ["{{ModuleClass}}"],
+  // request: {
+  //   params: {{ClassName}}IdParamsSchema,
+  //   body: jsonContent(Update{{ClassName}}Schema, "Update {{module}} payload")
+  // },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(z.object({ message: z.string() }), "Updated"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Not found")
+  }
+});
+
+const destroyRoute = createRoute({
+  path: "/{id}",
+  method: "delete",
+  tags: ["{{ModuleClass}}"],
+  // request: {
+  //   params: {{ClassName}}IdParamsSchema
+  // },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(z.object({ message: z.string() }), "Deleted"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Not found")
+  }
+});
+
+export default group()
+  .api(indexRoute, (c: any) => c.json({ message: "{{module}} list not implemented", data: [] }))
+  .api(showRoute, (c: any) => c.json({ message: "{{module}} item not implemented", data: { id: 0, name: "" } }))
+  .api(storeRoute, (c: any) => c.json({ message: "{{module}} create not implemented" }, 201))
+  .api(updateRoute, (c: any) => c.json({ message: "{{module}} update not implemented" }))
+  .api(destroyRoute, (c: any) => c.json({ message: "{{module}} delete not implemented" }));
+
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.

package/hono/src/framework/maker-cli/stubs/route/standalone.plain.ts.stub

@@ -0,0 +1,37 @@
+import { group } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+
+/**
+ * {{module}} routes for {{controller}}.
+ *
+ * Wire each handler to a controller:
+ *   import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.js";
+ *   export default group().get("/", index).get("/:id", show) ...
+ *
+ * Add validation with the validate() helper:
+ *   import { validate } from "@/framework/facade.js";
+ *   import { {{ClassName}}IdParamsSchema } from "@/modules/{{module}}/schemas/{{controller}}.js";
+ *   const params = await validate({{ClassName}}IdParamsSchema, c.req.param());
+ */
+
+export default group()
+  .get("/", (c: any) => c.json({ message: "{{module}} list not implemented", data: [] }))
+  .get("/:id", (c: any) => c.json({ message: "{{module}} item not implemented", data: { id: 0, name: "" } }))
+  .post("/", (c: any) => c.json({ message: "{{module}} create not implemented" }, 201))
+  .put("/:id", (c: any) => c.json({ message: "{{module}} update not implemented" }))
+  .delete("/:id", (c: any) => c.json({ message: "{{module}} delete not implemented" }));
+
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.

package/hono/src/framework/maker-cli/stubs/{controller/schema.plain.ts.stub → schema/name.plain.ts.stub}

@@ -1,14 +1,14 @@
-import { z } from "@/framework/facade.js";
-
-export const Create{{ClassName}}Schema = z.object({
-  name: z.string().min(1)
-});
-
-export const Update{{ClassName}}Schema = z.object({
-  name: z.string().min(1)
-});
-
-export const {{ClassName}}IdParamsSchema = z.object({
-  id: z.coerce.number().int().positive()
-});
+import { z } from "@/framework/facade.js";
+
+export const Create{{ClassName}}Schema = z.object({
+  name: z.string().min(1)
+});
+
+export const Update{{ClassName}}Schema = z.object({
+  name: z.string().min(1)
+});
+
+export const {{ClassName}}IdParamsSchema = z.object({
+  id: z.coerce.number().int().positive()
+});
 

package/hono/src/framework/maker-cli/stubs/{controller/schema.ts.stub → schema/name.ts.stub}

@@ -1,33 +1,33 @@
-import { z } from "@/framework/facade.js";
-
-export const {{ClassName}}ItemSchema = z.object({
-  id: z.number(),
-  name: z.string()
-});
-
-export const Create{{ClassName}}Schema = z.object({
-  name: z.string().min(1)
-});
-
-export const Update{{ClassName}}Schema = z.object({
-  name: z.string().min(1)
-});
-
-export const {{ClassName}}IdParamsSchema = z.object({
-  id: z.coerce.number().int().positive()
-});
-
-export const {{ClassName}}ListResponseSchema = z.object({
-  message: z.string(),
-  data: z.array({{ClassName}}ItemSchema)
-});
-
-export const {{ClassName}}ResponseSchema = z.object({
-  message: z.string(),
-  data: {{ClassName}}ItemSchema
-});
-
-export const {{ClassName}}MessageSchema = z.object({
-  message: z.string()
-});
+import { z } from "@/framework/facade.js";
+
+export const {{ClassName}}ItemSchema = z.object({
+  id: z.number(),
+  name: z.string()
+});
+
+export const Create{{ClassName}}Schema = z.object({
+  name: z.string().min(1)
+});
+
+export const Update{{ClassName}}Schema = z.object({
+  name: z.string().min(1)
+});
+
+export const {{ClassName}}IdParamsSchema = z.object({
+  id: z.coerce.number().int().positive()
+});
+
+export const {{ClassName}}ListResponseSchema = z.object({
+  message: z.string(),
+  data: z.array({{ClassName}}ItemSchema)
+});
+
+export const {{ClassName}}ResponseSchema = z.object({
+  message: z.string(),
+  data: {{ClassName}}ItemSchema
+});
+
+export const {{ClassName}}MessageSchema = z.object({
+  message: z.string()
+});
 

package/hono/src/framework/maker-cli/stubs/service/name.plain.ts.stub

@@ -0,0 +1,67 @@
+import { eq } from "drizzle-orm";
+import { db } from "@/framework/facade.js";
+
+/**
+ * Why: Returns every {{controller}} row for list screens.
+ * When: Called by the controller's index() handler.
+ * Where: GET /{{controller}} route.
+ *
+ * TODO: import your model and query it, for example:
+ *   import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{controller}}.js";
+ *   return db.select().from({{tableVariable}});
+ */
+export const {{controller}}Service = {  
+  /**
+  * Why: CRUD service for {{controller}}.
+  * When: Consumed directly by the controller as `{{controller}}Service.list()`, etc.
+  * Where: Wired into the module's controller handlers.
+  */
+  list: async () => {
+    void db;
+    return [];
+  },
+
+  /**
+   * Why: Returns one {{controller}} row by primary key.
+   * When: Called by the controller's show/update/destroy handlers.
+   * Where: Reused across GET/PUT/DELETE /{{controller}}/{id} routes.
+   *
+   * TODO: query the model by id and return the row, or null when missing.
+   */
+  findOne: async (_id: number) => {
+    return null;
+  },
+
+  /**
+   * Why: Persists a new {{controller}} row.
+   * When: Called by the controller's store() handler.
+   * Where: POST /{{controller}} route.
+   *
+   * TODO: insert the validated payload and return the created row.
+   */
+  create: async (_data: Record<string, unknown>) => {
+    return null;
+  },
+
+  /**
+   * Why: Applies a partial change to one {{controller}} row.
+   * When: Called by the controller's update() handler.
+   * Where: PUT/PATCH /{{controller}}/{id} route.
+   *
+   * TODO: update by id, refresh updatedAt, and return the row, or null when missing.
+   */
+  update: async (_id: number, _data: Record<string, unknown>) => {
+    return null;
+  },
+
+  /**
+   * Why: Removes one {{controller}} row.
+   * When: Called by the controller's destroy() handler.
+   * Where: DELETE /{{controller}}/{id} route.
+   *
+   * TODO: delete by id and return the removed row, or null when missing.
+   */
+  remove: async (_id: number) => {
+    return null;
+  },
+};