create-m5kdev 0.25.2 → 0.26.1

package/templates/minimal-app/apps/webapp/src/modules/posts/hooks/usePostActions.ts.tpl

@@ -1,116 +1,108 @@
-import { useDialog } from "@m5kdev/web-ui/components/DialogProvider";
-import type {
-  PostCreateInputSchema,
-  PostPublishInputSchema,
-  PostSoftDeleteInputSchema,
-  PostUpdateInputSchema,
-} from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { useTranslation } from "react-i18next";
-import { toast } from "sonner";
-import { useTRPC } from "@/utils/trpc";
-
-/**
- * Reusable post mutations: save (create/update), publish, and delete with a
- * confirmation dialog. Toasts and list invalidation live here so any component
- * can trigger the same action with the same behavior.
- */
-export function usePostActions() {
-  const { t } = useTranslation("blog{{PACKAGE_SCOPE}}");
-  const trpc = useTRPC();
-  const queryClient = useQueryClient();
-  const showDialog = useDialog();
-
-  const invalidateList = async () => {
-    await queryClient.invalidateQueries(trpc.posts.list.queryFilter());
-  };
-
-  const onError = (error: unknown) => {
-    toast.error(error instanceof Error ? error.message : String(error));
-  };
-
-  const createMutation = useMutation(
-    trpc.posts.create.mutationOptions({
-      onSuccess: async () => {
-        toast.success(t("posts.toast.created"));
-        await invalidateList();
-      },
-      onError,
-    })
-  );
-
-  const updateMutation = useMutation(
-    trpc.posts.update.mutationOptions({
-      onSuccess: async () => {
-        toast.success(t("posts.toast.updated"));
-        await invalidateList();
-      },
-      onError,
-    })
-  );
-
-  const publishMutation = useMutation(
-    trpc.posts.publish.mutationOptions({
-      onSuccess: async () => {
-        toast.success(t("posts.toast.published"));
-        await invalidateList();
-      },
-      onError,
-    })
-  );
-
-  const deleteMutation = useMutation(
-    trpc.posts.softDelete.mutationOptions({
-      onSuccess: async () => {
-        toast.success(t("posts.toast.deleted"));
-        await invalidateList();
-      },
-      onError,
-    })
-  );
-
-  /** Create when `id` is missing, update otherwise. Resolves false on failure (toast already shown). */
-  const savePost = async (payload: PostCreateInputSchema, id?: string): Promise<boolean> => {
-    try {
-      if (id) {
-        await updateMutation.mutateAsync({ id, ...payload } as PostUpdateInputSchema);
-      } else {
-        await createMutation.mutateAsync(payload);
-      }
-      return true;
-    } catch {
-      return false;
-    }
-  };
-
-  const publishPost = (id: string) => {
-    void publishMutation
-      .mutateAsync({ id } satisfies PostPublishInputSchema)
-      .catch(() => undefined);
-  };
-
-  const deletePost = (id: string) => {
-    showDialog({
-      title: t("posts.deleteDialog.title"),
-      description: t("posts.deleteDialog.body"),
-      intent: "danger",
-      cancelable: true,
-      confirmLabel: t("posts.deleteDialog.confirm"),
-      cancelLabel: t("posts.deleteDialog.cancel"),
-      onConfirm: () => {
-        void deleteMutation
-          .mutateAsync({ id } satisfies PostSoftDeleteInputSchema)
-          .catch(() => undefined);
-      },
-    });
-  };
-
-  return {
-    savePost,
-    publishPost,
-    deletePost,
-    isSaving: createMutation.isPending || updateMutation.isPending,
-    publishingId: publishMutation.isPending ? publishMutation.variables?.id : undefined,
-    deletingId: deleteMutation.isPending ? deleteMutation.variables?.id : undefined,
-  };
-}
+import { useDialog } from "@m5kdev/web-ui/components/DialogProvider";
+import type { PostCreateInputSchema } from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+import { useTRPC } from "@/utils/trpc";
+
+/**
+ * Reusable post mutations: save (create/update), publish, and delete with a
+ * confirmation dialog. Toasts and list invalidation live here so any component
+ * can trigger the same action with the same behavior.
+ */
+export function usePostActions() {
+  const { t } = useTranslation("{{APP_SLUG}}");
+  const trpc = useTRPC();
+  const queryClient = useQueryClient();
+  const showDialog = useDialog();
+
+  const invalidateList = async () => {
+    await queryClient.invalidateQueries(trpc.posts.list.queryFilter());
+  };
+
+  const onError = (error: unknown) => {
+    toast.error(error instanceof Error ? error.message : String(error));
+  };
+
+  const createMutation = useMutation(
+    trpc.posts.create.mutationOptions({
+      onSuccess: async () => {
+        toast.success(t("posts.toast.created"));
+        await invalidateList();
+      },
+      onError,
+    })
+  );
+
+  const updateMutation = useMutation(
+    trpc.posts.update.mutationOptions({
+      onSuccess: async () => {
+        toast.success(t("posts.toast.updated"));
+        await invalidateList();
+      },
+      onError,
+    })
+  );
+
+  const publishMutation = useMutation(
+    trpc.posts.publish.mutationOptions({
+      onSuccess: async () => {
+        toast.success(t("posts.toast.published"));
+        await invalidateList();
+      },
+      onError,
+    })
+  );
+
+  const deleteMutation = useMutation(
+    trpc.posts.softDelete.mutationOptions({
+      onSuccess: async () => {
+        toast.success(t("posts.toast.deleted"));
+        await invalidateList();
+      },
+      onError,
+    })
+  );
+
+  /** Create when `id` is missing, update otherwise. Resolves false on failure (toast already shown). */
+  const savePost = async (payload: PostCreateInputSchema, id?: string): Promise<boolean> => {
+    try {
+      if (id) {
+        await updateMutation.mutateAsync({ id, ...payload });
+      } else {
+        await createMutation.mutateAsync(payload);
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  const publishPost = (id: string) => {
+    // input shape is enforced by the router's inferred mutation type
+    void publishMutation.mutateAsync({ id }).catch(() => undefined);
+  };
+
+  const deletePost = (id: string) => {
+    showDialog({
+      title: t("posts.deleteDialog.title"),
+      description: t("posts.deleteDialog.body"),
+      intent: "danger",
+      cancelable: true,
+      confirmLabel: t("posts.deleteDialog.confirm"),
+      cancelLabel: t("posts.deleteDialog.cancel"),
+      onConfirm: () => {
+        void deleteMutation.mutateAsync({ id }).catch(() => undefined);
+      },
+    });
+  };
+
+  return {
+    savePost,
+    publishPost,
+    deletePost,
+    isSaving: createMutation.isPending || updateMutation.isPending,
+    publishingId: publishMutation.isPending ? publishMutation.variables?.id : undefined,
+    deletingId: deleteMutation.isPending ? deleteMutation.variables?.id : undefined,
+  };
+}

package/templates/minimal-app/apps/webapp/src/modules/posts/hooks/usePostsList.ts.tpl

@@ -1,18 +1,20 @@
+import type { QueryInput } from "@m5kdev/commons/modules/schemas/query.schema";
 import {
   POST_FILTER_VALUES,
   POSTS_PAGE_SIZE,
 } from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.constants";
-import type {
-  PostsListInputSchema,
-  PostsListOutputSchema,
-} from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
+import type { AppRouter } from "{{PACKAGE_SCOPE}}/server/types";
 import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
+import type { inferRouterOutputs } from "@trpc/server";
 import { parseAsInteger, parseAsString, parseAsStringLiteral, useQueryState } from "nuqs";
 import { startTransition, useDeferredValue, useMemo } from "react";
 import { useTRPC } from "@/utils/trpc";
 
 export type PostStatusFilter = (typeof POST_FILTER_VALUES)[number];
-export type PostRow = PostsListOutputSchema["rows"][number];
+
+// row/list types are inferred from the server router — no hand-written mirrors
+type PostsListOutput = inferRouterOutputs<AppRouter>["posts"]["list"];
+export type PostRow = PostsListOutput["rows"][number];
 
 const STATUS_PARSER = parseAsStringLiteral(POST_FILTER_VALUES).withDefault("all");
 
@@ -26,12 +28,16 @@ export function usePostsList() {
 
   const deferredSearch = useDeferredValue(search);
 
-  const listInput = useMemo<PostsListInputSchema>(
+  // the generic list contract: q for global search, filters for column filters
+  const listInput = useMemo<QueryInput>(
     () => ({
       page,
       limit: POSTS_PAGE_SIZE,
-      search: deferredSearch || undefined,
-      status: status === "all" ? undefined : status,
+      q: deferredSearch || undefined,
+      filters:
+        status === "all"
+          ? undefined
+          : [{ columnId: "status", type: "enum", method: "equals", value: status }],
       sort: "updatedAt",
       order: "desc",
     }),
@@ -39,7 +45,7 @@ export function usePostsList() {
   );
 
   const { data, isLoading, isFetching } = useQuery(
-    trpc.posts.list.queryOptions(listInput) as unknown as UseQueryOptions<PostsListOutputSchema>
+    trpc.posts.list.queryOptions(listInput) as unknown as UseQueryOptions<PostsListOutput>
   );
 
   const rows = data?.rows ?? [];

package/templates/minimal-app/apps/webapp/src/modules/posts/hooks/usePostsRoute.ts.tpl

@@ -1,13 +1,13 @@
-import { usePostActions } from "./usePostActions";
-import { usePostsList } from "./usePostsList";
-
-/**
- * Screen-level hook for the posts route: composes the list query/URL state and
- * the reusable post actions so the route component makes a single call.
- */
-export function usePostsRoute() {
-  const list = usePostsList();
-  const actions = usePostActions();
-
-  return { ...list, ...actions };
-}
+import { usePostActions } from "./usePostActions";
+import { usePostsList } from "./usePostsList";
+
+/**
+ * Screen-level hook for the posts route: composes the list query/URL state and
+ * the reusable post actions so the route component makes a single call.
+ */
+export function usePostsRoute() {
+  const list = usePostsList();
+  const actions = usePostActions();
+
+  return { ...list, ...actions };
+}

package/templates/minimal-app/apps/webapp/src/modules/posts/posts.utils.ts.tpl

@@ -1,16 +1,16 @@
-export function formatDate(value: Date | null | undefined): string {
-  if (!value) {
-    return "Not scheduled";
-  }
-
-  return new Intl.DateTimeFormat(undefined, {
-    dateStyle: "medium",
-    timeStyle: "short",
-  }).format(new Date(value));
-}
-
-export function getReadingTime(content: string): string {
-  const words = content.trim().split(/\s+/).filter(Boolean).length;
-  const minutes = Math.max(1, Math.ceil(words / 180));
-  return `${minutes} min read`;
-}
+export function formatDate(value: Date | null | undefined): string {
+  if (!value) {
+    return "Not scheduled";
+  }
+
+  return new Intl.DateTimeFormat(undefined, {
+    dateStyle: "medium",
+    timeStyle: "short",
+  }).format(new Date(value));
+}
+
+export function getReadingTime(content: string): string {
+  const words = content.trim().split(/\s+/).filter(Boolean).length;
+  const minutes = Math.max(1, Math.ceil(words / 180));
+  return `${minutes} min read`;
+}

package/templates/minimal-app/apps/webapp/src/utils/i18n.ts.tpl

@@ -1,13 +1,13 @@
-// @ts-expect-error-next-line: virtual module
-import resources from "virtual:i18next-loader";
-import i18n from "i18next";
-import { initReactI18next } from "react-i18next";
-
-i18n.use(initReactI18next).init({
-  fallbackLng: "en",
-  debug: import.meta.env.MODE === "development",
-  interpolation: {
-    escapeValue: false,
-  },
-  resources,
-});
+// @ts-expect-error-next-line: virtual module
+import resources from "virtual:i18next-loader";
+import i18n from "i18next";
+import { initReactI18next } from "react-i18next";
+
+i18n.use(initReactI18next).init({
+  fallbackLng: "en",
+  debug: import.meta.env.MODE === "development",
+  interpolation: {
+    escapeValue: false,
+  },
+  resources,
+});

package/templates/minimal-app/apps/webapp/src/utils/trpc.ts.tpl

@@ -1,6 +1,10 @@
-import { useAppTRPC } from "@m5kdev/frontend/modules/app/hooks/useAppTrpc";
-import type { AppRouter } from "{{PACKAGE_SCOPE}}/server/types";
-import type { TRPCOptionsProxy } from "@trpc/tanstack-react-query";
-export function useTRPC(): TRPCOptionsProxy<AppRouter> {
-  return useAppTRPC<AppRouter>();
-}
+import { useAppTRPC, useAppTRPCClient } from "@m5kdev/frontend/modules/app/hooks/useAppTrpc";
+import type { AppRouter } from "{{PACKAGE_SCOPE}}/server/types";
+
+export function useTRPC() {
+  return useAppTRPC<AppRouter>();
+}
+
+export function useTRPCClient() {
+  return useAppTRPCClient<AppRouter>();
+}

package/templates/minimal-app/apps/webapp/src/vite-env.d.ts.tpl

@@ -1 +1 @@
-/// <reference types="vite/client" />
+/// <reference types="vite/client" />

package/templates/minimal-app/apps/webapp/translations/{app.json.tpl → en/app.json.tpl}

@@ -1,7 +1,7 @@
-{
-  "user.role.user": "User",
-  "user.role.admin": "Admin",
-  "organization.role.member": "Member",
-  "organization.role.admin": "Admin",
-  "organization.role.owner": "Owner"
-}
+{
+  "user.role.user": "User",
+  "user.role.admin": "Admin",
+  "organization.role.member": "Member",
+  "organization.role.admin": "Admin",
+  "organization.role.owner": "Owner"
+}