@tatara/cli 0.0.0-stage → 0.1.0

package/templates/generators/resource/files/src/modules/__moduleKebab__/validators/__nameKebab__.validators.ts

@@ -0,0 +1,30 @@
+import { z } from "@hono/zod-openapi";
+
+export const __nameCamel__Schema = z
+	.object({
+		id: z.string().openapi({ example: "01920000-0000-7000-8000-000000000000" }),
+		name: z.string().openapi({ example: "My __nameTitle__" }),
+		description: z.string().nullable(),
+		createdAt: z.string().openapi({ format: "date-time" }),
+		updatedAt: z.string().openapi({ format: "date-time" }),
+	})
+	.openapi("__namePascal__");
+
+export const create__namePascal__Schema = z
+	.object({
+		name: z.string().trim().min(1).max(200),
+		description: z.string().max(5000).nullable().optional(),
+	})
+	.openapi("Create__namePascal__");
+
+export const update__namePascal__Schema = create__namePascal__Schema
+	.partial()
+	.openapi("Update__namePascal__");
+
+export const __nameCamel__ParamsSchema = z.object({
+	id: z.string().min(1).openapi({ param: { name: "id", in: "path" } }),
+});
+
+export type __namePascal__ = z.infer<typeof __nameCamel__Schema>;
+export type Create__namePascal__Input = z.infer<typeof create__namePascal__Schema>;
+export type Update__namePascal__Input = z.infer<typeof update__namePascal__Schema>;

package/templates/generators/resource/files+authz/src/modules/__moduleKebab__/permissions/__nameKebab__.permissions.ts

@@ -0,0 +1,21 @@
+import { definePermissions } from "#core/authz/catalog";
+
+export default definePermissions({
+	resources: {
+		"__nameKebab__": {
+			read: { scoped: false },
+			create: { scoped: false },
+			update: { scoped: false },
+			delete: { scoped: false },
+		},
+	},
+	roleGrants: {
+		admin: [
+			["__nameKebab__", "read"],
+			["__nameKebab__", "create"],
+			["__nameKebab__", "update"],
+			["__nameKebab__", "delete"],
+		],
+		member: [["__nameKebab__", "read"]],
+	},
+});

package/templates/generators/resource/files+drizzle/src/modules/__moduleKebab__/services/__nameKebab__.service.ts

@@ -0,0 +1,78 @@
+import { count, desc, eq } from "drizzle-orm";
+import { db, type Executor } from "#core/db/client";
+import { newId } from "#core/db/id";
+import { NotFoundError } from "#core/http/errors";
+import type { PaginationQuery } from "#core/http/response";
+import { __namePluralCamel__ } from "#modules/__moduleKebab__/db/__nameKebab__.schema";
+import type {
+	Create__namePascal__Input,
+	__namePascal__,
+	Update__namePascal__Input,
+} from "#modules/__moduleKebab__/validators/__nameKebab__.validators";
+
+type Row = typeof __namePluralCamel__.$inferSelect;
+
+function to__namePascal__(row: Row): __namePascal__ {
+	return {
+		id: row.id,
+		name: row.name,
+		description: row.description,
+		createdAt: row.createdAt.toISOString(),
+		updatedAt: row.updatedAt.toISOString(),
+	};
+}
+
+export async function list__namePluralPascal__(
+	{ page, pageSize }: PaginationQuery,
+	executor: Executor = db,
+) {
+	const [rows, totals] = await Promise.all([
+		executor
+			.select()
+			.from(__namePluralCamel__)
+			.orderBy(desc(__namePluralCamel__.id))
+			.limit(pageSize)
+			.offset((page - 1) * pageSize),
+		executor.select({ total: count() }).from(__namePluralCamel__),
+	]);
+	return { items: rows.map(to__namePascal__), total: totals[0]?.total ?? 0 };
+}
+
+export async function get__namePascal__(id: string, executor: Executor = db): Promise<__namePascal__> {
+	const [row] = await executor
+		.select()
+		.from(__namePluralCamel__)
+		.where(eq(__namePluralCamel__.id, id))
+		.limit(1);
+	if (!row) throw new NotFoundError("__nameTitle__");
+	return to__namePascal__(row);
+}
+
+export async function create__namePascal__(
+	input: Create__namePascal__Input,
+	executor: Executor = db,
+): Promise<__namePascal__> {
+	const id = newId();
+	await executor
+		.insert(__namePluralCamel__)
+		.values({ id, name: input.name, description: input.description ?? null });
+	return get__namePascal__(id, executor);
+}
+
+export async function update__namePascal__(
+	id: string,
+	input: Update__namePascal__Input,
+	executor: Executor = db,
+): Promise<__namePascal__> {
+	await get__namePascal__(id, executor);
+	await executor
+		.update(__namePluralCamel__)
+		.set({ ...input, updatedAt: new Date() })
+		.where(eq(__namePluralCamel__.id, id));
+	return get__namePascal__(id, executor);
+}
+
+export async function remove__namePascal__(id: string, executor: Executor = db): Promise<void> {
+	await get__namePascal__(id, executor);
+	await executor.delete(__namePluralCamel__).where(eq(__namePluralCamel__.id, id));
+}

package/templates/generators/resource/files+drizzle+mysql/src/modules/__moduleKebab__/db/__nameKebab__.schema.ts

@@ -0,0 +1,9 @@
+import { mysqlTable, text, timestamp, varchar } from "drizzle-orm/mysql-core";
+
+export const __namePluralCamel__ = mysqlTable("__namePluralSnake__", {
+	id: varchar({ length: 36 }).primaryKey(),
+	name: varchar({ length: 200 }).notNull(),
+	description: text(),
+	createdAt: timestamp({ fsp: 3, mode: "date" }).notNull().defaultNow(),
+	updatedAt: timestamp({ fsp: 3, mode: "date" }).notNull().defaultNow(),
+});

package/templates/generators/resource/files+drizzle+postgres/src/modules/__moduleKebab__/db/__nameKebab__.schema.ts

@@ -0,0 +1,9 @@
+import { pgTable, text, timestamp, uuid, varchar } from "drizzle-orm/pg-core";
+
+export const __namePluralCamel__ = pgTable("__namePluralSnake__", {
+	id: uuid().primaryKey(),
+	name: varchar({ length: 200 }).notNull(),
+	description: text(),
+	createdAt: timestamp({ withTimezone: true, mode: "date" }).notNull().defaultNow(),
+	updatedAt: timestamp({ withTimezone: true, mode: "date" }).notNull().defaultNow(),
+});

package/templates/generators/resource/files+prisma/prisma/models/__nameKebab__.prisma

@@ -0,0 +1,9 @@
+model __namePascal__ {
+  id          String   @id @db.VarChar(36)
+  name        String   @db.VarChar(200)
+  description String?  @db.Text
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @default(now()) @updatedAt @map("updated_at")
+
+  @@map("__namePluralSnake__")
+}

package/templates/generators/resource/files+prisma/src/modules/__moduleKebab__/services/__nameKebab__.service.ts

@@ -0,0 +1,73 @@
+import { db, type Executor } from "#core/db/client";
+import { newId } from "#core/db/id";
+import { NotFoundError } from "#core/http/errors";
+import type { PaginationQuery } from "#core/http/response";
+import type {
+	Create__namePascal__Input,
+	__namePascal__,
+	Update__namePascal__Input,
+} from "#modules/__moduleKebab__/validators/__nameKebab__.validators";
+
+interface Row {
+	id: string;
+	name: string;
+	description: string | null;
+	createdAt: Date;
+	updatedAt: Date;
+}
+
+function to__namePascal__(row: Row): __namePascal__ {
+	return {
+		id: row.id,
+		name: row.name,
+		description: row.description,
+		createdAt: row.createdAt.toISOString(),
+		updatedAt: row.updatedAt.toISOString(),
+	};
+}
+
+export async function list__namePluralPascal__(
+	{ page, pageSize }: PaginationQuery,
+	executor: Executor = db,
+) {
+	const [rows, total] = await Promise.all([
+		executor.__nameCamel__.findMany({
+			orderBy: { id: "desc" },
+			skip: (page - 1) * pageSize,
+			take: pageSize,
+		}),
+		executor.__nameCamel__.count(),
+	]);
+	return { items: rows.map(to__namePascal__), total };
+}
+
+export async function get__namePascal__(id: string, executor: Executor = db): Promise<__namePascal__> {
+	const row = await executor.__nameCamel__.findUnique({ where: { id } });
+	if (!row) throw new NotFoundError("__nameTitle__");
+	return to__namePascal__(row);
+}
+
+export async function create__namePascal__(
+	input: Create__namePascal__Input,
+	executor: Executor = db,
+): Promise<__namePascal__> {
+	const row = await executor.__nameCamel__.create({
+		data: { id: newId(), name: input.name, description: input.description ?? null },
+	});
+	return to__namePascal__(row);
+}
+
+export async function update__namePascal__(
+	id: string,
+	input: Update__namePascal__Input,
+	executor: Executor = db,
+): Promise<__namePascal__> {
+	await get__namePascal__(id, executor);
+	const row = await executor.__nameCamel__.update({ where: { id }, data: input });
+	return to__namePascal__(row);
+}
+
+export async function remove__namePascal__(id: string, executor: Executor = db): Promise<void> {
+	await get__namePascal__(id, executor);
+	await executor.__nameCamel__.delete({ where: { id } });
+}

package/templates/generators/route/files/src/modules/__moduleKebab__/routes/__nameKebab__.routes.ts

@@ -0,0 +1,29 @@
+import { createRoute } from "@hono/zod-openapi";
+import { errorResponses, jsonContent, success, successSchema } from "#core/http/response";
+import { createRouter, defineRoutes } from "#core/http/routes";
+// tatara:slot imports
+import {
+	__nameCamel__QuerySchema,
+	__nameCamel__ResponseSchema,
+} from "#modules/__moduleKebab__/validators/__nameKebab__.validators";
+
+const router = createRouter();
+
+router.openapi(
+	createRoute({
+		method: "get",
+		path: "/",
+		tags: ["__modulePascal__"],
+		summary: "__nameTitle__",
+		// tatara:slot guard-read
+		request: { query: __nameCamel__QuerySchema },
+		responses: {
+			200: jsonContent(successSchema(__nameCamel__ResponseSchema), "__nameTitle__"),
+			...errorResponses(400),
+			// tatara:slot auth-errors
+		},
+	}),
+	(c) => c.json(success({ message: `__nameKebab__: ${c.req.valid("query").q ?? "ok"}` }), 200),
+);
+
+export default defineRoutes({ app: "api", basePath: "/__nameKebab__", router });

package/templates/generators/route/files/src/modules/__moduleKebab__/validators/__nameKebab__.validators.ts

@@ -0,0 +1,9 @@
+import { z } from "@hono/zod-openapi";
+
+export const __nameCamel__QuerySchema = z.object({
+	q: z.string().max(100).optional(),
+});
+
+export const __nameCamel__ResponseSchema = z
+	.object({ message: z.string() })
+	.openapi("__namePascal__Response");

package/templates/generators/route/files+authz/src/modules/__moduleKebab__/permissions/__nameKebab__.permissions.ts

@@ -0,0 +1,13 @@
+import { definePermissions } from "#core/authz/catalog";
+
+export default definePermissions({
+	resources: {
+		"__nameKebab__": {
+			read: { scoped: false },
+		},
+	},
+	roleGrants: {
+		admin: [["__nameKebab__", "read"]],
+		member: [["__nameKebab__", "read"]],
+	},
+});

package/templates/generators/schedule/files/src/modules/__moduleKebab__/schedules/__nameKebab__.ts

@@ -0,0 +1,11 @@
+import { defineSchedule } from "#core/jobs/define";
+
+export default defineSchedule({
+	name: "__moduleKebab__.__nameKebab__",
+	// every day at 02:00 UTC
+	cron: "0 2 * * *",
+	lockTtlMs: 10 * 60_000,
+	async run({ logger }) {
+		logger.info("__moduleKebab__.__nameKebab__ ran");
+	},
+});

package/templates/generators/schema/files+drizzle+mysql/src/modules/__moduleKebab__/db/__nameKebab__.schema.ts

@@ -0,0 +1,9 @@
+import { mysqlTable, text, timestamp, varchar } from "drizzle-orm/mysql-core";
+
+export const __namePluralCamel__ = mysqlTable("__namePluralSnake__", {
+	id: varchar({ length: 36 }).primaryKey(),
+	name: varchar({ length: 200 }).notNull(),
+	description: text(),
+	createdAt: timestamp({ fsp: 3, mode: "date" }).notNull().defaultNow(),
+	updatedAt: timestamp({ fsp: 3, mode: "date" }).notNull().defaultNow(),
+});

package/templates/generators/schema/files+drizzle+postgres/src/modules/__moduleKebab__/db/__nameKebab__.schema.ts

@@ -0,0 +1,9 @@
+import { pgTable, text, timestamp, uuid, varchar } from "drizzle-orm/pg-core";
+
+export const __namePluralCamel__ = pgTable("__namePluralSnake__", {
+	id: uuid().primaryKey(),
+	name: varchar({ length: 200 }).notNull(),
+	description: text(),
+	createdAt: timestamp({ withTimezone: true, mode: "date" }).notNull().defaultNow(),
+	updatedAt: timestamp({ withTimezone: true, mode: "date" }).notNull().defaultNow(),
+});

package/templates/generators/schema/files+prisma/prisma/models/__nameKebab__.prisma

@@ -0,0 +1,9 @@
+model __namePascal__ {
+  id          String   @id @db.VarChar(36)
+  name        String   @db.VarChar(200)
+  description String?  @db.Text
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @default(now()) @updatedAt @map("updated_at")
+
+  @@map("__namePluralSnake__")
+}

package/templates/generators/service/files/src/modules/__moduleKebab__/services/__nameKebab__.service.ts

@@ -0,0 +1,4 @@
+/** __nameTitle__: business logic for the __moduleKebab__ module. */
+export function __nameCamel__(input: { value: string }): { result: string } {
+	return { result: input.value };
+}

package/templates/generators/service/files/src/modules/__moduleKebab__/tests/__nameKebab__.service.test.ts

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+import { __nameCamel__ } from "#modules/__moduleKebab__/services/__nameKebab__.service";
+
+describe("__nameCamel__", () => {
+	it("returns a result", () => {
+		expect(__nameCamel__({ value: "x" })).toEqual({ result: "x" });
+	});
+});

package/templates/versions.json

@@ -0,0 +1,34 @@
+{
+  "hono": "4.13.13",
+  "@hono/node-server": "2.1.5",
+  "@hono/zod-openapi": "1.6.3",
+  "@scalar/hono-api-reference": "0.12.12",
+  "zod": "4.6.7",
+  "@t3-oss/env-core": "0.13.11",
+  "pino": "10.4.0",
+  "pino-pretty": "13.2.0",
+  "typescript": "7.0.2",
+  "@types/node": "24.19.2",
+  "vitest": "5.0.4",
+  "tsdown": "0.23.1",
+  "@biomejs/biome": "2.5.15",
+  "pg": "8.23.1",
+  "@types/pg": "8.23.1",
+  "mysql2": "3.24.6",
+  "mariadb": "3.4.5",
+  "drizzle-orm": "0.45.4",
+  "drizzle-kit": "0.31.11",
+  "prisma": "7.10.0",
+  "@prisma/client": "7.10.0",
+  "@prisma/adapter-pg": "7.10.0",
+  "@prisma/adapter-mariadb": "7.10.0",
+  "better-auth": "1.7.8",
+  "jose": "6.2.12",
+  "bullmq": "6.3.15",
+  "ioredis": "6.0.0",
+  "croner": "10.0.1",
+  "@aws-sdk/client-s3": "3.1152.0",
+  "@aws-sdk/s3-request-presigner": "3.1152.0",
+  "nodemailer": "10.1.1",
+  "@types/nodemailer": "8.0.2"
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.