create-fullstack-scaffold 0.4.11 → 0.4.13

package/template/src/admin/pages/UsersPage.tsx

@@ -1,4 +1,4 @@
-import { useState, useEffect } from 'react'
+import { useState, useEffect, useCallback } from 'react'
 import {
   Table,
   Card,
@@ -37,18 +37,20 @@ export const UsersPage: React.FC = () => {
   const [form] = Form.useForm<UserFormData>()
   const { roleLabels } = useRoleLabels()
 
-  const fetchUsers = async () => {
+  const fetchUsers = useCallback(async () => {
     try {
-      const data = await api(apiClient.api.admin.users.$get()).withLoading(t('users.loading')).json()
+      const data = await api(apiClient.api.admin.users.$get())
+        .withLoading(t('users.loading'))
+        .json()
       setUsers(data)
     } catch {
       // handled by api-request
     }
-  }
+  }, [t])
 
   useEffect(() => {
     fetchUsers()
-  }, [])
+  }, [fetchUsers])
 
   const handleCreate = () => {
     setEditingUser(null)
@@ -271,7 +273,9 @@ export const UsersPage: React.FC = () => {
           >
             <Select placeholder={t('users.rolePlaceholder')}>
               <Select.Option value={Role.SUPER_ADMIN}>{t('users.superAdmin')}</Select.Option>
-              <Select.Option value={Role.CUSTOMER_SERVICE}>{t('users.customerService')}</Select.Option>
+              <Select.Option value={Role.CUSTOMER_SERVICE}>
+                {t('users.customerService')}
+              </Select.Option>
               <Select.Option value={Role.USER}>{t('users.normalUser')}</Select.Option>
             </Select>
           </Form.Item>

package/template/src/admin/stores/themeStore.ts

@@ -21,7 +21,7 @@ export const useThemeStore = create<ThemeState>()(
     {
       name: 'admin-theme',
       onRehydrateStorage: () => {
-        return (state) => {
+        return state => {
           if (state) {
             document.documentElement.setAttribute('data-theme', state.mode)
           }

package/template/src/cli/modules/admin/index.ts

@@ -2,6 +2,21 @@ import type { SiteInstance } from '@dyyz1993/xcli-core'
 import { ok, fail } from '@dyyz1993/xcli-core'
 import { z } from 'zod'
 import { getClient } from '@cli/utils/api'
+import type { Role } from '@shared/modules/permission'
+
+const createUserParams = z.object({
+  username: z.string().min(1).describe('Username'),
+  email: z.string().email().describe('Email'),
+  password: z.string().min(6).describe('Password'),
+  role: z.enum(['super_admin', 'customer_service', 'user']).default('user').describe('Role'),
+})
+
+const updateUserParams = z.object({
+  id: z.string().describe('User ID'),
+  username: z.string().optional().describe('New username'),
+  email: z.string().email().optional().describe('New email'),
+  role: z.enum(['super_admin', 'customer_service', 'user']).optional().describe('New role'),
+})
 
 export function registerAdminCommands(site: SiteInstance) {
   site.command('dashboard', {
@@ -84,29 +99,21 @@ export function registerAdminCommands(site: SiteInstance) {
 
   site.command('create-user', {
     description: 'Create a new user',
-    parameters: z.object({
-      username: z.string().min(1).describe('Username'),
-      email: z.string().email().describe('Email'),
-      password: z.string().min(6).describe('Password'),
-      role: z.enum(['super_admin', 'customer_service', 'user']).default('user').describe('Role'),
-    }),
-    handler: async (params: unknown) => {
-      const p = params as {
-        username: string
-        email: string
-        password: string
-        role: 'super_admin' | 'customer_service' | 'user'
-      }
+    parameters: createUserParams,
+    handler: async params => {
+      // @ts-expect-error -- auto-command passes unknown, we parse from zod schema
+      const p: z.infer<typeof createUserParams> = params
       try {
         const client = getClient()
         const res = await client.api.admin.users.$post({
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
           json: {
             username: p.username,
             email: p.email,
             password: p.password,
-            role: p.role,
-          } as any,
+            // Role enum values overlap with z.enum string literals — safe cast for RPC compatibility
+            // eslint-disable-next-line local-rules/no-type-assertion-on-shared-types
+            role: p.role as Role,
+          },
         })
         const data = await res.json()
         return ok(data, ['User created'])
@@ -118,19 +125,10 @@ export function registerAdminCommands(site: SiteInstance) {
 
   site.command('update-user', {
     description: 'Update a user',
-    parameters: z.object({
-      id: z.string().describe('User ID'),
-      username: z.string().optional().describe('New username'),
-      email: z.string().email().optional().describe('New email'),
-      role: z.enum(['super_admin', 'customer_service', 'user']).optional().describe('New role'),
-    }),
-    handler: async (params: unknown) => {
-      const p = params as {
-        id: string
-        username?: string
-        email?: string
-        role?: 'super_admin' | 'customer_service' | 'user'
-      }
+    parameters: updateUserParams,
+    handler: async params => {
+      // @ts-expect-error -- auto-command passes unknown, we parse from zod schema
+      const p: z.infer<typeof updateUserParams> = params
       const { id, ...rest } = p
       const body: Record<string, string | undefined> = {}
       if (rest.username) body.username = rest.username
@@ -138,7 +136,7 @@ export function registerAdminCommands(site: SiteInstance) {
       if (rest.role) body.role = rest.role
       try {
         const client = getClient()
-        const res = await client.api.admin.users[':id'].$put({ param: { id }, json: body as Record<string, string | null | undefined> })
+        const res = await client.api.admin.users[':id'].$put({ param: { id }, json: body })
         const data = await res.json()
         return ok(data, ['User updated'])
       } catch (err) {

package/template/src/cli/modules/content/index.ts

@@ -48,7 +48,10 @@ export function registerContentCommands(site: SiteInstance) {
     parameters: z.object({
       title: z.string().min(1).describe('Content title'),
       content: z.string().min(1).describe('Content body'),
-      category: z.enum(['article', 'announcement', 'tutorial', 'news', 'policy']).default('article').describe('Category'),
+      category: z
+        .enum(['article', 'announcement', 'tutorial', 'news', 'policy'])
+        .default('article')
+        .describe('Category'),
       tags: z.string().optional().describe('Comma-separated tags'),
     }),
     handler: async (params: unknown) => {
@@ -57,7 +60,12 @@ export function registerContentCommands(site: SiteInstance) {
         const client = getClient()
         const tags = p.tags ? p.tags.split(',') : undefined
         const res = await client.api.contents.$post({
-          json: { title: p.title, content: p.content, category: p.category as 'article' | 'announcement' | 'tutorial' | 'news' | 'policy', tags },
+          json: {
+            title: p.title,
+            content: p.content,
+            category: p.category as 'article' | 'announcement' | 'tutorial' | 'news' | 'policy',
+            tags,
+          },
         })
         const data = await res.json()
         return ok(data, ['Content created'])

package/template/src/cli/modules/dispute/index.ts

@@ -50,7 +50,10 @@ export function registerDisputeCommands(site: SiteInstance) {
       'order-no': z.string().describe('Order number'),
       'customer-name': z.string().describe('Customer name'),
       'customer-email': z.string().email().describe('Customer email'),
-      type: z.enum(['refund', 'product_quality', 'service_quality', 'delivery', 'other']).default('other').describe('Type'),
+      type: z
+        .enum(['refund', 'product_quality', 'service_quality', 'delivery', 'other'])
+        .default('other')
+        .describe('Type'),
       description: z.string().min(1).describe('Description'),
       amount: z.coerce.number().positive().describe('Amount'),
     }),
@@ -89,7 +92,10 @@ export function registerDisputeCommands(site: SiteInstance) {
     description: 'Update a dispute status',
     parameters: z.object({
       id: z.string().describe('Dispute ID'),
-      status: z.enum(['pending', 'resolved', 'investigating', 'rejected']).optional().describe('New status'),
+      status: z
+        .enum(['pending', 'resolved', 'investigating', 'rejected'])
+        .optional()
+        .describe('New status'),
     }),
     handler: async (params: unknown) => {
       const p = params as { id: string; status?: string }

package/template/src/cli/modules/file/index.ts

@@ -13,7 +13,12 @@ export function registerFileCommands(site: SiteInstance) {
       'expiry-seconds': z.coerce.number().default(3600).describe('URL expiry in seconds'),
     }),
     handler: async (params: unknown) => {
-      const p = params as { namespace: string; filename: string; private: boolean; 'expiry-seconds': number }
+      const p = params as {
+        namespace: string
+        filename: string
+        private: boolean
+        'expiry-seconds': number
+      }
       try {
         const client = getClient()
         const res = await client.api['generate-url'].$post({

package/template/src/cli/modules/index.ts

@@ -14,6 +14,7 @@ import { registerOrderCommands } from './order'
 import { registerPermissionCommands } from './permission'
 import { registerTenantCommands } from './tenant'
 import { registerTicketCommands } from './ticket'
+import { registerMerchantCommands } from './merchant'
 
 export function registerBuiltinCommands(app: Core) {
   const api = app.loader.getAPI()
@@ -38,6 +39,7 @@ export function registerBuiltinCommands(app: Core) {
   registerPermissionCommands(site)
   registerTenantCommands(site)
   registerTicketCommands(site)
+  registerMerchantCommands(site)
 }
 
 export {
@@ -56,4 +58,5 @@ export {
   registerPermissionCommands,
   registerTenantCommands,
   registerTicketCommands,
+  registerMerchantCommands,
 }

package/template/src/cli/modules/merchant/index.ts

@@ -0,0 +1,123 @@
+import type { SiteInstance } from '@dyyz1993/xcli-core'
+import { ok, fail } from '@dyyz1993/xcli-core'
+import { z } from 'zod'
+import { getClient } from '@cli/utils/api'
+
+const createProductParams = z.object({
+  name: z.string().min(1).describe('Product name'),
+  description: z.string().max(1000).describe('Product description'),
+  price: z.coerce.number().positive().describe('Product price'),
+  stock: z.coerce.number().int().min(0).default(0).describe('Stock quantity'),
+  status: z
+    .enum(['active', 'inactive', 'out_of_stock'])
+    .default('active')
+    .describe('Product status'),
+  'image-url': z.string().url().nullable().default(null).describe('Image URL'),
+})
+
+export function registerMerchantCommands(site: SiteInstance) {
+  site.command('login', {
+    description: 'Login as merchant',
+    parameters: z.object({
+      username: z.string().min(1).describe('Merchant username'),
+      password: z.string().min(6).describe('Merchant password'),
+    }),
+    handler: async (params: unknown) => {
+      const p = params as { username: string; password: string }
+      try {
+        const client = getClient()
+        const res = await client.api.merchant.login.$post({
+          json: { username: p.username, password: p.password },
+        })
+        const data = await res.json()
+        return ok(data)
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : 'Failed to login')
+      }
+    },
+  })
+
+  site.command('me', {
+    description: 'Get current merchant profile',
+    parameters: z.object({}),
+    handler: async () => {
+      try {
+        const client = getClient()
+        const res = await client.api.merchant.me.$get()
+        const data = await res.json()
+        return ok(data)
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : 'Failed to get merchant profile')
+      }
+    },
+  })
+
+  site.command('stats', {
+    description: 'Get merchant statistics',
+    parameters: z.object({}),
+    handler: async () => {
+      try {
+        const client = getClient()
+        const res = await client.api.merchant.stats.$get()
+        const data = await res.json()
+        return ok(data)
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : 'Failed to get merchant stats')
+      }
+    },
+  })
+
+  site.command('list-products', {
+    description: 'List merchant products',
+    parameters: z.object({
+      page: z.coerce.number().int().positive().default(1).describe('Page number'),
+      'page-size': z.coerce.number().int().positive().max(100).default(20).describe('Page size'),
+      status: z
+        .enum(['active', 'inactive', 'out_of_stock'])
+        .optional()
+        .describe('Filter by status'),
+    }),
+    handler: async (params: unknown) => {
+      const p = params as { page: number; 'page-size': number; status?: string }
+      try {
+        const client = getClient()
+        const query: Record<string, string> = {
+          page: String(p.page),
+          pageSize: String(p['page-size']),
+        }
+        if (p.status) query.status = p.status
+        const res = await client.api.merchant.products.$get({ query })
+        const data = await res.json()
+        return ok(data)
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : 'Failed to list products')
+      }
+    },
+  })
+
+  site.command('create-product', {
+    description: 'Create a new product',
+    parameters: createProductParams,
+    handler: async params => {
+      // @ts-expect-error -- auto-command passes unknown, we parse from zod schema
+      const p: z.infer<typeof createProductParams> = params
+      try {
+        const client = getClient()
+        const res = await client.api.merchant.products.$post({
+          json: {
+            name: p.name,
+            description: p.description,
+            price: p.price,
+            stock: p.stock,
+            status: p.status,
+            imageUrl: p['image-url'],
+          },
+        })
+        const data = await res.json()
+        return ok(data, ['Product created'])
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : 'Failed to create product')
+      }
+    },
+  })
+}

package/template/src/cli/modules/order/index.ts

@@ -13,7 +13,12 @@ export function registerOrderCommands(site: SiteInstance) {
       'customer-name': z.string().optional().describe('Filter by customer name'),
     }),
     handler: async (params: unknown) => {
-      const p = params as { limit: number; offset: number; status?: string; 'customer-name'?: string }
+      const p = params as {
+        limit: number
+        offset: number
+        status?: string
+        'customer-name'?: string
+      }
       try {
         const client = getClient()
         const query: Record<string, string> = {
@@ -58,7 +63,12 @@ export function registerOrderCommands(site: SiteInstance) {
       amount: z.coerce.number().positive().describe('Order amount'),
     }),
     handler: async (params: unknown) => {
-      const p = params as { 'customer-name': string; 'customer-email': string; 'product-name': string; amount: number }
+      const p = params as {
+        'customer-name': string
+        'customer-email': string
+        'product-name': string
+        amount: number
+      }
       try {
         const client = getClient()
         const res = await client.api.orders.$post({
@@ -81,7 +91,10 @@ export function registerOrderCommands(site: SiteInstance) {
     description: 'Update order status',
     parameters: z.object({
       id: z.string().describe('Order ID'),
-      status: z.enum(['pending', 'processing', 'completed', 'cancelled', 'disputed']).optional().describe('New status'),
+      status: z
+        .enum(['pending', 'processing', 'completed', 'cancelled', 'disputed'])
+        .optional()
+        .describe('New status'),
     }),
     handler: async (params: unknown) => {
       const p = params as { id: string; status?: string }

package/template/src/cli/modules/permission/index.ts

@@ -152,7 +152,13 @@ export function registerPermissionCommands(site: SiteInstance) {
       'resource-type': z.string().optional().describe('Filter by resource type'),
     }),
     handler: async (params: unknown) => {
-      const p = params as { limit: number; offset: number; 'user-id'?: string; action?: string; 'resource-type'?: string }
+      const p = params as {
+        limit: number
+        offset: number
+        'user-id'?: string
+        action?: string
+        'resource-type'?: string
+      }
       try {
         const client = getClient()
         const query: Record<string, string> = {

package/template/src/cli/modules/ticket/index.ts

@@ -50,7 +50,10 @@ export function registerTicketCommands(site: SiteInstance) {
       'customer-email': z.string().email().describe('Customer email'),
       subject: z.string().min(1).describe('Ticket subject'),
       description: z.string().min(1).describe('Ticket description'),
-      category: z.enum(['technical', 'billing', 'feature_request', 'bug_report', 'general']).default('general').describe('Category'),
+      category: z
+        .enum(['technical', 'billing', 'feature_request', 'bug_report', 'general'])
+        .default('general')
+        .describe('Category'),
       priority: z.enum(['low', 'medium', 'high', 'urgent']).default('medium').describe('Priority'),
     }),
     handler: async (params: unknown) => {
@@ -70,7 +73,12 @@ export function registerTicketCommands(site: SiteInstance) {
             customerEmail: p['customer-email'],
             subject: p.subject,
             description: p.description,
-            category: p.category as 'technical' | 'billing' | 'feature_request' | 'bug_report' | 'general',
+            category: p.category as
+              | 'technical'
+              | 'billing'
+              | 'feature_request'
+              | 'bug_report'
+              | 'general',
             priority: p.priority as 'low' | 'medium' | 'high' | 'urgent',
           },
         })
@@ -86,7 +94,10 @@ export function registerTicketCommands(site: SiteInstance) {
     description: 'Update ticket status',
     parameters: z.object({
       id: z.string().describe('Ticket ID'),
-      status: z.enum(['open', 'closed', 'in_progress', 'waiting_customer', 'resolved']).optional().describe('New status'),
+      status: z
+        .enum(['open', 'closed', 'in_progress', 'waiting_customer', 'resolved'])
+        .optional()
+        .describe('New status'),
       'assigned-to': z.string().optional().describe('Assign to user'),
     }),
     handler: async (params: unknown) => {

package/template/src/client/index.css

@@ -1,4 +1,4 @@
-@import "tailwindcss";
+@import 'tailwindcss';
 
 /**
  * Global styles
@@ -10,91 +10,89 @@
 
 body {
   margin: 0;
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
-    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
-    sans-serif;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu',
+    'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
 }
 
 code {
-  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',
-    monospace;
+  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New', monospace;
 }
 
 #root {
   min-height: 100vh;
 }
 
-[data-theme="dark"] {
+[data-theme='dark'] {
   color-scheme: dark;
 }
 
-[data-theme="dark"] body {
+[data-theme='dark'] body {
   background-color: #141414;
   color: rgba(255, 255, 255, 0.85);
 }
 
-[data-theme="dark"] .bg-white {
+[data-theme='dark'] .bg-white {
   background-color: #1f1f1f !important;
 }
 
-[data-theme="dark"] .bg-gray-50 {
+[data-theme='dark'] .bg-gray-50 {
   background-color: #1a1a1a !important;
 }
 
-[data-theme="dark"] .bg-gray-100 {
+[data-theme='dark'] .bg-gray-100 {
   background-color: #1f1f1f !important;
 }
 
-[data-theme="dark"] .text-gray-900 {
+[data-theme='dark'] .text-gray-900 {
   color: rgba(255, 255, 255, 0.95) !important;
 }
 
-[data-theme="dark"] .text-gray-800 {
+[data-theme='dark'] .text-gray-800 {
   color: rgba(255, 255, 255, 0.85) !important;
 }
 
-[data-theme="dark"] .text-gray-700 {
+[data-theme='dark'] .text-gray-700 {
   color: rgba(255, 255, 255, 0.75) !important;
 }
 
-[data-theme="dark"] .text-gray-600 {
+[data-theme='dark'] .text-gray-600 {
   color: rgba(255, 255, 255, 0.65) !important;
 }
 
-[data-theme="dark"] .text-gray-500 {
+[data-theme='dark'] .text-gray-500 {
   color: rgba(255, 255, 255, 0.55) !important;
 }
 
-[data-theme="dark"] .border-gray-200 {
+[data-theme='dark'] .border-gray-200 {
   border-color: #303030 !important;
 }
 
-[data-theme="dark"] .border-gray-100 {
+[data-theme='dark'] .border-gray-100 {
   border-color: #262626 !important;
 }
 
-[data-theme="dark"] .hover\:bg-gray-100:hover {
+[data-theme='dark'] .hover\:bg-gray-100:hover {
   background-color: rgba(255, 255, 255, 0.08) !important;
 }
 
-[data-theme="dark"] .hover\:bg-gray-50:hover {
+[data-theme='dark'] .hover\:bg-gray-50:hover {
   background-color: rgba(255, 255, 255, 0.06) !important;
 }
 
-[data-theme="dark"] .text-gray-400 {
+[data-theme='dark'] .text-gray-400 {
   color: #8c8c8c;
 }
 
-[data-theme="dark"] .text-gray-300 {
+[data-theme='dark'] .text-gray-300 {
   color: #a0a0a0;
 }
 
-[data-theme="dark"] .bg-blue-50 {
+[data-theme='dark'] .bg-blue-50 {
   background-color: rgba(59, 130, 246, 0.1);
 }
 
-[data-theme="dark"] .border-gray-300 {
+[data-theme='dark'] .border-gray-300 {
   border-color: #434343;
 }

package/template/vite.config.ts

@@ -85,6 +85,11 @@ export default defineConfig({
           }),
         ],
       },
+      onwarn(warning, defaultHandler) {
+        // Suppress antd "use client" directive warnings (React Server Components marker)
+        if (warning.code === 'MODULE_LEVEL_DIRECTIVE') return
+        defaultHandler(warning)
+      },
     },
   },
   resolve: {