@tulipes/cli 0.1.1 → 0.2.0-rc.2

package/templates/overlays/no-queues/modules/users/controllers/users.controllers.ts

@@ -0,0 +1,107 @@
+import { forgetUser } from "@app/auth";
+import type { Request, RequestHandler, Response } from "express";
+import type { Ctx } from "@tulipes/core/boot";
+import { HttpError } from "@tulipes/core/http";
+
+/**
+ * One class per controller, holding the context. Each method returns a
+ * handler, so the routes file stays a table of contents.
+ *
+ * Every response goes through `res.respond`, which wraps the payload in
+ * the app's envelope. Failures are thrown rather than responded — the
+ * framework's terminal handler builds the same envelope from them — so a
+ * handler only ever writes the happy path.
+ *
+ * Thrown messages are i18n KEYS: the handler translates them in this
+ * module's namespace and derives the error code from the key, so
+ * "notFound" becomes NOT_FOUND with a translated message.
+ */
+export class UsersController {
+  readonly #ctx: Ctx;
+
+  constructor(ctx: Ctx) {
+    this.#ctx = ctx;
+  }
+
+  list(): RequestHandler {
+    return async (req: Request, res: Response) => {
+      // ?page and ?per_page, already clamped by config.pagination.
+      const { per_page, skip } = req.page;
+      const User = this.#ctx.models!.get("User");
+
+      const [users, total_items] = await Promise.all([
+        User.find().select("email role -_id").skip(skip).limit(per_page).lean(),
+        User.countDocuments(),
+      ]);
+
+      // Passing total_items is what marks this a page: respond fills in
+      // page, per_page and total_pages from the request and the count.
+      res.respond({ data: users, meta: { total_items } });
+    };
+  }
+
+  /** Soft delete: the row stays in mongo but leaves every ordinary query. */
+  softDelete(): RequestHandler {
+    return async (req: Request, res: Response) => {
+      const user = await this.#ctx.models!.get("User").findOne({ email: req.params.email });
+      if (!user) throw new HttpError(404, "notFound");
+
+      // The account leaves every query, so its sessions resolve to nobody on
+      // the cold path; the cached identities would not know, so they go too.
+      await forgetUser(this.#ctx, String(user._id));
+      await (user as unknown as { softDelete(): Promise<unknown> }).softDelete();
+      res.respond({ data: { email: req.params.email, soft_deleted: true } });
+    };
+  }
+
+  listDeleted(): RequestHandler {
+    return async (_req: Request, res: Response) => {
+      const deleted = await this.#ctx.models!
+        .get("User")
+        .find({ is_deleted: true })
+        .setOptions({ withDeleted: true } as Record<string, unknown>)
+        .select("email role -_id")
+        .lean();
+
+      res.respond({ data: deleted });
+    };
+  }
+
+  create(): RequestHandler {
+    return async (req: Request, res: Response) => {
+      const { email } = (req.body ?? {}) as { email?: string };
+      // `field` is what puts this against the input in the envelope.
+      if (!email) throw new HttpError(422, "emailRequired", { field: "email" });
+
+      await this.#ctx.models!.get("User").create({ email });
+
+      res.respond({ status: 201, data: { email } });
+    };
+  }
+
+  ping(): RequestHandler {
+    return (req: Request, res: Response) => {
+      res.respond({
+        data: {
+          module: "users",
+          locale: req.locale,
+          max_sessions: this.#ctx.config.users?.maxSessions,
+        },
+      });
+    };
+  }
+
+  /** Demonstrates HttpError — the framework renders it into the envelope. */
+  demoMissing(): RequestHandler {
+    return async () => {
+      throw new HttpError(404, "notFound", { details: { hint: "demo endpoint" } });
+    };
+  }
+
+  /** Demonstrates an unexpected error: anonymous 500 outside development. */
+  demoBoom(): RequestHandler {
+    return async () => {
+      throw new Error("secret internals that must not leak in production");
+    };
+  }
+}

package/templates/versions.json

@@ -0,0 +1,11 @@
+{
+  "pnpm": "10.28.0",
+  "@tulipes/core": "0.11.0-rc.2",
+  "@tulipes/cli": "0.2.0-rc.2",
+  "@tulipes/spec": "0.3.2-rc.2",
+  "@tulipes/mongoose": "0.2.0-rc.2",
+  "@tulipes/bullmq": "0.2.0-rc.2",
+  "@tulipes/socket.io": "0.1.2-rc.2",
+  "@tulipes/testing": "0.1.0-rc.2",
+  "@tulipes/mcp": "0.1.0-rc.2"
+}

package/dist/minimal.d.ts

@@ -1,2 +0,0 @@
-export declare function starterTests(production: boolean): string;
-export declare function renderMinimalProject(name: string, coreVersion: string, cliVersion: string): [string, string][];