vona-cli-set-api 1.1.174 → 1.1.176

package/cli/templates/tools/crudAnalysis/aggregate/src/dto/{{resourceName}}AggregateRes.tsx_

@@ -0,0 +1,11 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>AggregateRes extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>AggregateRes>()
+export class Dto<%=argv.resourceNameCapitalize%>AggregateRes extends $Dto.analysisAggregate(<%=argv.resourceName%>Analysis) {}

package/cli/templates/tools/crudAnalysis/common/src/lib/{{resourceName}}Analysis.ts_

@@ -0,0 +1,14 @@
+import { $defineAnalysis } from 'vona-module-a-orm';
+
+import { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+// One allowlist drives request controls, response fields, and bounded execution.
+export const <%=argv.resourceName%>Analysis = $defineAnalysis(() => Model<%=argv.resourceNameCapitalize%>, {
+  groups: ['name'],
+  aggrs: { count: ['*'] },
+  defaults: {
+    group: { groups: ['name'], aggrs: { count: ['*'] } },
+    aggregate: { aggrs: { count: ['*'] } },
+  },
+  limits: { maxGroups: 3, maxMetrics: 10, maxGroupRows: 1000 },
+});

package/cli/templates/tools/crudAnalysis/common/test/{{resourceName}}Analysis.test.ts_

@@ -0,0 +1,81 @@
+import assert from 'node:assert/strict';
+import { randomUUID } from 'node:crypto';
+import { describe, it } from 'node:test';
+import { app } from 'vona-mock';
+
+import { <%=argv.resourceName%>Analysis } from '../src/lib/<%=argv.resourceName%>Analysis.ts';
+
+describe('<%=argv.resourceName%>Analysis.test.ts', { concurrency: false }, () => {
+  it('returns default and requested-only string counts with validated controls', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      const scope = app.scope('<%=argv.moduleInfo.relativeName%>');
+      const name = `__analysis_${randomUUID()}`;
+      const fixture = await scope.model.<%=argv.resourceName%>.insert({ name });
+      try {
+        await app.bean.passport.signinMock();
+        const queries = [
+          { name },
+          // List controls are validated but do not paginate the analysis population.
+          { where: { id: fixture.id }, columns: ['id'], orders: 'name,desc', pageNo: 2, pageSize: 1 },
+        ];
+        for (const query of queries) {
+          const groups = await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/group', { query });
+          assert.deepEqual(groups, [{ name, count_all: '1' }]);
+          assert.deepEqual(await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/group', {
+            query: { ...query, groups: JSON.stringify(['name']), aggrs: JSON.stringify({ count: ['*'] }) },
+          }), groups);
+          assert.deepEqual(await scope.service.<%=argv.resourceName%>.group({
+            where: { id: fixture.id }, groups: ['name'], aggrs: { count: ['*'] },
+          }), groups);
+          const aggregate = await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/aggregate', { query });
+          assert.deepEqual(aggregate, { count_all: '1' });
+          assert.deepEqual(await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/aggregate', {
+            query: { ...query, aggrs: JSON.stringify({ count: ['*'] }) },
+          }), aggregate);
+          assert.deepEqual(await scope.service.<%=argv.resourceName%>.aggregate({
+            where: { id: fixture.id }, aggrs: { count: ['*'] },
+          }), aggregate);
+        }
+        for (const action of ['group', 'aggregate'] as const) {
+          for (const controls of [
+            { pageNo: 2, pageSize: 0 },
+            { aggrs: JSON.stringify({}) },
+            { aggrs: JSON.stringify({ count: ['*', '*'] }) },
+            { aggrs: JSON.stringify({ count: ['unknown'] }) },
+            { aggrs: '{invalid-json' },
+          ]) {
+            await assert.rejects(() => app.bean.executor.performAction('get', `<%=argv.moduleActionPathRaw%>/${action}`, {
+              query: { name, ...controls },
+            }));
+          }
+        }
+        // The shared policy does not enable analysis controls on ordinary select.
+        await assert.rejects(() => app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>', {
+          query: { name, aggrs: JSON.stringify({ count: ['*'] }) },
+        }));
+        for (const groups of [[], ['name', 'name'], ['description'], ['unknown']]) {
+          await assert.rejects(() => app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/group', {
+            query: { name, groups: JSON.stringify(groups) },
+          }));
+        }
+        await assert.rejects(() => scope.service.<%=argv.resourceName%>.group({ aggrs: { count: [] } }));
+        assert.deepEqual(<%=argv.resourceName%>Analysis.defaults.group, {
+          groups: ['name'], aggrs: { count: ['*'] },
+        });
+        await assert.rejects(() => app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/aggregate', {
+          query: { name, groups: JSON.stringify(['name']) },
+        }));
+        await assert.rejects(() => scope.service.<%=argv.resourceName%>.aggregate({ aggrs: { count: [] } }));
+        assert.deepEqual(<%=argv.resourceName%>Analysis.defaults.aggregate, { aggrs: { count: ['*'] } });
+        await scope.model.<%=argv.resourceName%>.deleteById(fixture.id);
+        for (const query of queries) {
+          assert.deepEqual(await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/group', { query }), []);
+          assert.deepEqual(await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/aggregate', { query }), { count_all: '0' });
+        }
+      } finally {
+        await scope.model.<%=argv.resourceName%>.deleteById(fixture.id, { disableDeleted: true });
+        await app.bean.passport.signout();
+      }
+    });
+  });
+});

package/cli/templates/tools/crudAnalysis/group/src/dto/{{resourceName}}GroupResItem.tsx_

@@ -0,0 +1,11 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>GroupResItem extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>GroupResItem>()
+export class Dto<%=argv.resourceNameCapitalize%>GroupResItem extends $Dto.analysisGroup(<%=argv.resourceName%>Analysis) {}

package/cli/templates/tools/crudBasic/boilerplate/src/controller/{{resourceName}}.ts_

@@ -1,5 +1,5 @@
 import type { TableIdentity } from 'table-identity';
-import type { IQueryParams } from 'vona-module-a-orm';
+import type { IQueryParams, TypeAnalysisGroupParams, TypeAnalysisAggregateParams } from 'vona-module-a-orm';
 import type { IDecoratorControllerOptions } from 'vona-module-a-web';
 
 import { BeanBase } from 'vona';
@@ -17,6 +17,9 @@ import { Dto<%=argv.resourceNameCapitalize%>SelectReq } from '../dto/<%=argv.res
 import { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
 import { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.resourceName%>Update.tsx';
 import { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>GroupResItem } from '../dto/<%=argv.resourceName%>GroupResItem.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>AggregateRes } from '../dto/<%=argv.resourceName%>AggregateRes.tsx';
+import type { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 export interface IControllerOptions<%=argv.resourceNameCapitalize%> extends IDecoratorControllerOptions {}
 
@@ -39,6 +42,20 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.select(params);
   }
 
+  @Web.get('group', { summary: $locale('<%=argv.resourceNameCapitalize%>Group') })
+  @Api.body(v.array(v.object(Dto<%=argv.resourceNameCapitalize%>GroupResItem)))
+  @Passport.rbac({ actionInherit: 'select' })
+  async group(@Arg.filter(Dto<%=argv.resourceNameCapitalize%>SelectReq, { mode: 'group' }) params: TypeAnalysisGroupParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>GroupResItem[]> {
+    return await this.scope.service.<%=argv.resourceName%>.group(params);
+  }
+
+  @Web.get('aggregate', { summary: $locale('<%=argv.resourceNameCapitalize%>Aggregate') })
+  @Api.body(Dto<%=argv.resourceNameCapitalize%>AggregateRes)
+  @Passport.rbac({ actionInherit: 'select' })
+  async aggregate(@Arg.filter(Dto<%=argv.resourceNameCapitalize%>SelectReq, { mode: 'aggregate' }) params: TypeAnalysisAggregateParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>AggregateRes> {
+    return await this.scope.service.<%=argv.resourceName%>.aggregate(params);
+  }
+
   @Web.get(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>View') })
   @Api.body(v.optional(), v.object(Dto<%=argv.resourceNameCapitalize%>View))
   @Passport.rbac()

package/cli/templates/tools/crudBasic/boilerplate/src/dto/{{resourceName}}SelectReq.tsx_

@@ -7,10 +7,12 @@ import z from 'zod';
 import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
 
 import { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 export interface IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq extends IDecoratorDtoOptions {}
 
 @Dto<IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq>({
+  analysis: <%=argv.resourceName%>Analysis,
   openapi: { filter: { table: '<%=argv.moduleResourceName%>' } },
   fields: {
     name: $makeSchema(v.optional(), z.string()),

package/cli/templates/tools/crudBasic/boilerplate/src/service/{{resourceName}}.ts_

@@ -1,9 +1,10 @@
 import type { TableIdentity } from 'table-identity';
-import type { IQueryParams } from 'vona-module-a-orm';
+import type { IQueryParams, TypeAnalysisGroupParams, TypeAnalysisAggregateParams } from 'vona-module-a-orm';
 
 import { BeanBase } from 'vona';
 import { Service } from 'vona-module-a-bean';
 import { Core } from 'vona-module-a-core';
+import { $executeAnalysisGroup, $executeAnalysisAggregate } from 'vona-module-a-orm';
 
 import type { Dto<%=argv.resourceNameCapitalize%>Create } from '../dto/<%=argv.resourceName%>Create.tsx';
 import type { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
@@ -11,6 +12,10 @@ import type { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.r
 import type { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
 import type { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
 import type { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+import type { Dto<%=argv.resourceNameCapitalize%>GroupResItem } from '../dto/<%=argv.resourceName%>GroupResItem.tsx';
+import type { Dto<%=argv.resourceNameCapitalize%>AggregateRes } from '../dto/<%=argv.resourceName%>AggregateRes.tsx';
+
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 @Service()
 export class Service<%=argv.resourceNameCapitalize%> extends BeanBase {
@@ -22,6 +27,14 @@ export class Service<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.model.<%=argv.resourceName%>.selectAndCount(params);
   }
 
+  async group(params?: TypeAnalysisGroupParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>GroupResItem[]> {
+    return await $executeAnalysisGroup(this.scope.model.<%=argv.resourceName%>, <%=argv.resourceName%>Analysis, params);
+  }
+
+  async aggregate(params?: TypeAnalysisAggregateParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>AggregateRes> {
+    return await $executeAnalysisAggregate(this.scope.model.<%=argv.resourceName%>, <%=argv.resourceName%>Analysis, params);
+  }
+
   async view(id: TableIdentity): Promise<Dto<%=argv.resourceNameCapitalize%>View | undefined> {
     return await this.scope.model.<%=argv.resourceName%>.getById(id);
   }

package/cli/templates/tools/crudBasic/boilerplate/test/{{resourceName}}.test.ts_

@@ -29,6 +29,8 @@ describe('<%=argv.resourceName%>.test.ts', { concurrency: false }, () => {
       const expectedSummaries = {
         create: ['post', moduleApiPath, 'Create <%=argv.resourceNameCapitalize%>'],
         select: ['get', moduleApiPath, 'Query <%=argv.resourceNameCapitalize%> List'],
+        group: ['get', `${moduleApiPath}/group`, 'Group <%=argv.resourceNameCapitalize%>'],
+        aggregate: ['get', `${moduleApiPath}/aggregate`, 'Aggregate <%=argv.resourceNameCapitalize%>'],
         view: ['get', `${moduleApiPath}/{id}`, 'View <%=argv.resourceNameCapitalize%>'],
         update: ['patch', `${moduleApiPath}/{id}`, 'Update <%=argv.resourceNameCapitalize%>'],
         delete: ['delete', `${moduleApiPath}/{id}`, 'Delete <%=argv.resourceNameCapitalize%>'],
@@ -54,6 +56,8 @@ describe('<%=argv.resourceName%>.test.ts', { concurrency: false }, () => {
       const expectedInherits = {
         create: undefined,
         select: undefined,
+        group: `${controllerBeanFullName}#select`,
+        aggregate: `${controllerBeanFullName}#select`,
         view: undefined,
         update: undefined,
         delete: undefined,

package/cli/templates/tools/crudBasic/snippets/3-en-us.ts

@@ -40,6 +40,8 @@ export default metadataCustomSnippet({
       [`${resource}Update`]: `Update ${resource}`,
       [`${resource}Delete`]: `Delete ${resource}`,
       [`${resource}DeleteBulk`]: `Bulk Delete ${resource}`,
+      [`${resource}Group`]: `Group ${resource}`,
+      [`${resource}Aggregate`]: `Aggregate ${resource}`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudBasic/snippets/4-zh-cn.ts

@@ -23,6 +23,8 @@ export default metadataCustomSnippet({
       [`${resource}Update`]: `更新${resource}`,
       [`${resource}Delete`]: `删除${resource}`,
       [`${resource}DeleteBulk`]: `批量删除${resource}`,
+      [`${resource}Group`]: `${resource}分组统计`,
+      [`${resource}Aggregate`]: `${resource}汇总统计`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudStart/boilerplate/src/controller/{{resourceName}}.ts_

@@ -1,5 +1,5 @@
 import type { TableIdentity } from 'table-identity';
-import type { IQueryParams } from 'vona-module-a-orm';
+import type { IQueryParams, TypeAnalysisGroupParams, TypeAnalysisAggregateParams } from 'vona-module-a-orm';
 import type { IRbacScopeAccess } from 'vona-module-a-rbac';
 import type { IDecoratorControllerOptions } from 'vona-module-a-web';
 
@@ -18,6 +18,9 @@ import { Dto<%=argv.resourceNameCapitalize%>SelectReq } from '../dto/<%=argv.res
 import { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
 import { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.resourceName%>Update.tsx';
 import { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>GroupResItem } from '../dto/<%=argv.resourceName%>GroupResItem.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>AggregateRes } from '../dto/<%=argv.resourceName%>AggregateRes.tsx';
+import type { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 export interface IControllerOptions<%=argv.resourceNameCapitalize%> extends IDecoratorControllerOptions {}
 
@@ -40,6 +43,20 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.select(params);
   }
 
+  @Web.get('group', { summary: $locale('<%=argv.resourceNameCapitalize%>Group') })
+  @Api.body(v.array(v.object(Dto<%=argv.resourceNameCapitalize%>GroupResItem)))
+  @Passport.rbac({ actionInherit: 'select' })
+  async group(@Arg.filter(Dto<%=argv.resourceNameCapitalize%>SelectReq, { mode: 'group' }) params: TypeAnalysisGroupParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>GroupResItem[]> {
+    return await this.scope.service.<%=argv.resourceName%>.group(params);
+  }
+
+  @Web.get('aggregate', { summary: $locale('<%=argv.resourceNameCapitalize%>Aggregate') })
+  @Api.body(Dto<%=argv.resourceNameCapitalize%>AggregateRes)
+  @Passport.rbac({ actionInherit: 'select' })
+  async aggregate(@Arg.filter(Dto<%=argv.resourceNameCapitalize%>SelectReq, { mode: 'aggregate' }) params: TypeAnalysisAggregateParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>AggregateRes> {
+    return await this.scope.service.<%=argv.resourceName%>.aggregate(params);
+  }
+
   @Web.get(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>View') })
   @Api.body(v.optional(), v.object(Dto<%=argv.resourceNameCapitalize%>View))
   @Passport.rbac()

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}SelectReq.tsx_

@@ -7,10 +7,12 @@ import z from 'zod';
 import { ZovaRender } from 'zova-rest-cabloy-start-admin';
 
 import { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 export interface IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq extends IDecoratorDtoOptions {}
 
 @Dto<IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq>({
+  analysis: <%=argv.resourceName%>Analysis,
   openapi: { filter: { table: '<%=argv.moduleResourceName%>' } },
   fields: {
     name: $makeSchema(v.optional(), z.string()),

package/cli/templates/tools/crudStart/boilerplate/src/service/{{resourceName}}.ts_

@@ -1,9 +1,10 @@
 import type { TableIdentity } from 'table-identity';
-import type { IQueryParams } from 'vona-module-a-orm';
+import type { IQueryParams, TypeAnalysisGroupParams, TypeAnalysisAggregateParams } from 'vona-module-a-orm';
 
 import { BeanBase } from 'vona';
 import { Service } from 'vona-module-a-bean';
 import { Core } from 'vona-module-a-core';
+import { $executeAnalysisGroup, $executeAnalysisAggregate } from 'vona-module-a-orm';
 
 import type { Dto<%=argv.resourceNameCapitalize%>Create } from '../dto/<%=argv.resourceName%>Create.tsx';
 import type { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
@@ -11,6 +12,10 @@ import type { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.r
 import type { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
 import type { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
 import type { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+import type { Dto<%=argv.resourceNameCapitalize%>GroupResItem } from '../dto/<%=argv.resourceName%>GroupResItem.tsx';
+import type { Dto<%=argv.resourceNameCapitalize%>AggregateRes } from '../dto/<%=argv.resourceName%>AggregateRes.tsx';
+
+import { <%=argv.resourceName%>Analysis } from '../lib/<%=argv.resourceName%>Analysis.ts';
 
 @Service()
 export class Service<%=argv.resourceNameCapitalize%> extends BeanBase {
@@ -22,6 +27,14 @@ export class Service<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.model.<%=argv.resourceName%>.selectAndCount(params);
   }
 
+  async group(params?: TypeAnalysisGroupParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>GroupResItem[]> {
+    return await $executeAnalysisGroup(this.scope.model.<%=argv.resourceName%>, <%=argv.resourceName%>Analysis, params);
+  }
+
+  async aggregate(params?: TypeAnalysisAggregateParams<typeof <%=argv.resourceName%>Analysis>): Promise<Dto<%=argv.resourceNameCapitalize%>AggregateRes> {
+    return await $executeAnalysisAggregate(this.scope.model.<%=argv.resourceName%>, <%=argv.resourceName%>Analysis, params);
+  }
+
   async view(id: TableIdentity): Promise<Dto<%=argv.resourceNameCapitalize%>View | undefined> {
     return await this.scope.model.<%=argv.resourceName%>.getById(id);
   }

package/cli/templates/tools/crudStart/boilerplate/test/{{resourceName}}.test.ts_

@@ -19,7 +19,7 @@ describe('<%=argv.resourceName%>.test.ts', () => {
       await app.bean.passport.signinMock();
       try {
         app.bean.passport.current!.roles = [];
-        const actions = ['create', 'select', 'view', 'update', 'delete'];
+        const actions = ['create', 'select', 'view', 'update', 'delete', 'group', 'aggregate'];
         const permissions = await Promise.all(
           actions.map(action =>
             app.bean.permission.retrievePermissionAction(

package/cli/templates/tools/crudStart/snippets/3-en-us.ts

@@ -40,6 +40,8 @@ export default metadataCustomSnippet({
       [`${resource}View`]: `View ${resource}`,
       [`${resource}Update`]: `Update ${resource}`,
       [`${resource}Delete`]: `Delete ${resource}`,
+      [`${resource}Group`]: `Group ${resource}`,
+      [`${resource}Aggregate`]: `Aggregate ${resource}`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudStart/snippets/4-zh-cn.ts

@@ -23,6 +23,8 @@ export default metadataCustomSnippet({
       [`${resource}View`]: `查看${resource}`,
       [`${resource}Update`]: `更新${resource}`,
       [`${resource}Delete`]: `删除${resource}`,
+      [`${resource}Group`]: `${resource}分组统计`,
+      [`${resource}Aggregate`]: `${resource}汇总统计`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/dist/index.js

@@ -1134,9 +1134,6 @@ class CliBinTest extends BeanCliBase {
     if (argv.coverage) {
       args.push('--experimental-test-coverage');
     }
-    if (process.env.TEST_WHYISNODERUNNING === 'true') {
-      args.push('--import=why-is-node-running/include');
-    }
     args = args.concat([getImportEsm(resolveVonaLocalPaths(projectPath, 'test').generatedDir), testFile, projectPath, (!!argv.coverage).toString(), patterns.join(',')]);
     // args = args.concat(['--experimental-transform-types', getImportEsm(), testFile, projectPath, (!!argv.coverage).toString(), patterns.join(',')]);
     await runTestChild(args, projectPath);
@@ -1968,6 +1965,16 @@ class CliToolsCrud extends BeanCliBase {
   }
 }
 
+async function renderCrudAnalysis(cli, targetDir, setName) {
+  for (const part of ['common', 'group', 'aggregate']) {
+    await cli.template.renderBoilerplateAndSnippets({
+      targetDir,
+      setName,
+      boilerplatePath: `tools/crudAnalysis/${part}`
+    });
+  }
+}
+
 class CliToolsCrudBasic extends BeanCliBase {
   async execute() {
     const {
@@ -1999,6 +2006,7 @@ class CliToolsCrudBasic extends BeanCliBase {
       snippetsPath: 'tools/crudBasic/snippets',
       boilerplatePath: 'tools/crudBasic/boilerplate'
     });
+    await renderCrudAnalysis(this, targetDir, __ThisSetName__);
     // tools.metadata
     if (!argv.nometadata) {
       await this.helper.invokeCli([':tools:metadata', moduleName], {
@@ -2039,6 +2047,7 @@ class CliToolsCrudStart extends BeanCliBase {
       snippetsPath: 'tools/crudStart/snippets',
       boilerplatePath: 'tools/crudStart/boilerplate'
     });
+    await renderCrudAnalysis(this, targetDir, __ThisSetName__);
     // tools.metadata
     if (!argv.nometadata) {
       await this.helper.invokeCli([':tools:metadata', moduleName], {
@@ -2662,6 +2671,8 @@ class CliToolsMasterDetail extends BeanCliBase {
       service: path.join(detailRoot, 'src/service', `${argv.detailResourceName}.ts`),
       dtoDir: path.join(detailRoot, 'src/dto'),
       test: path.join(detailRoot, 'test', `${argv.detailResourceName}.test.ts`),
+      analysisTest: path.join(detailRoot, 'test', `${argv.detailResourceName}Analysis.test.ts`),
+      analysis: path.join(detailRoot, 'src/lib', `${argv.detailResourceName}Analysis.ts`),
       metaVersion: path.join(detailRoot, 'src/bean', 'meta.version.ts'),
       metaIndex: path.join(detailRoot, 'src/bean', 'meta.index.ts')
     };
@@ -2672,7 +2683,7 @@ class CliToolsMasterDetail extends BeanCliBase {
   }
   _removeStandaloneDetailSurface() {
     const files = this._detailPaths();
-    for (const file of [files.controller, files.service, files.test]) {
+    for (const file of [files.controller, files.service, files.test, files.analysisTest, files.analysis]) {
       if (fs.existsSync(file)) {
         fs.rmSync(file, {
           force: true

package/dist/lib/crudAnalysis.d.ts

@@ -0,0 +1,2 @@
+import type { BeanCliBase } from '@cabloy/cli';
+export declare function renderCrudAnalysis(cli: BeanCliBase, targetDir: string, setName: string): Promise<void>;

package/dist-cli/templates/tools/crudBasic/snippets/3-en-us.js

@@ -30,6 +30,8 @@ export default metadataCustomSnippet({
             [`${resource}Update`]: `Update ${resource}`,
             [`${resource}Delete`]: `Delete ${resource}`,
             [`${resource}DeleteBulk`]: `Bulk Delete ${resource}`,
+            [`${resource}Group`]: `Group ${resource}`,
+            [`${resource}Aggregate`]: `Aggregate ${resource}`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudBasic/snippets/4-zh-cn.js

@@ -20,6 +20,8 @@ export default metadataCustomSnippet({
             [`${resource}Update`]: `更新${resource}`,
             [`${resource}Delete`]: `删除${resource}`,
             [`${resource}DeleteBulk`]: `批量删除${resource}`,
+            [`${resource}Group`]: `${resource}分组统计`,
+            [`${resource}Aggregate`]: `${resource}汇总统计`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudStart/snippets/3-en-us.js

@@ -30,6 +30,8 @@ export default metadataCustomSnippet({
             [`${resource}View`]: `View ${resource}`,
             [`${resource}Update`]: `Update ${resource}`,
             [`${resource}Delete`]: `Delete ${resource}`,
+            [`${resource}Group`]: `Group ${resource}`,
+            [`${resource}Aggregate`]: `Aggregate ${resource}`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudStart/snippets/4-zh-cn.js

@@ -20,6 +20,8 @@ export default metadataCustomSnippet({
             [`${resource}View`]: `查看${resource}`,
             [`${resource}Update`]: `更新${resource}`,
             [`${resource}Delete`]: `删除${resource}`,
+            [`${resource}Group`]: `${resource}分组统计`,
+            [`${resource}Aggregate`]: `${resource}汇总统计`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-toolsIsolate/test.js

@@ -10,7 +10,7 @@ import { run } from 'node:test';
 import { lcov, spec } from 'node:test/reporters';
 import { fileURLToPath } from 'node:url';
 import { cast, createGeneralApp } from 'vona-core';
-import whyIsNodeRunning from 'why-is-node-running';
+import { formatActiveResourceCounts } from "./testDiagnostics.js";
 const argv = process.argv.slice(2);
 const projectPath = argv[0];
 const coverage = argv[1] === 'true';
@@ -66,13 +66,10 @@ async function testRun(projectPath, coverage, patterns) {
     const closeApplication = async () => {
         const [_, error] = await catchError(() => app.close());
         closeError = error;
-        // handles
+        // resource types only; no stack/source inspection
         if (process.env.TEST_WHYISNODERUNNING === 'true') {
             await sleep(2000);
-            const handles = process._getActiveHandles();
-            if (handles.length > 3) {
-                whyIsNodeRunning();
-            }
+            console.error(`Active resource counts: ${formatActiveResourceCounts(process.getActiveResourcesInfo())}`);
         }
     };
     const closeApplicationOnce = () => {

package/dist-toolsIsolate/testDiagnostics.d.ts

@@ -0,0 +1 @@
+export declare function formatActiveResourceCounts(types: readonly string[]): string;

package/dist-toolsIsolate/testDiagnostics.js

@@ -0,0 +1,6 @@
+export function formatActiveResourceCounts(types) {
+    const counts = new Map();
+    for (const type of types)
+        counts.set(type, (counts.get(type) ?? 0) + 1);
+    return JSON.stringify(Object.fromEntries([...counts].toSorted(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.174",
-  "gitHead": "b33ff20d9d60632c7e533b578f06a95a1f895e05",
+  "version": "1.1.176",
+  "gitHead": "d4ca173cd034aee6e73d037f86745c9919218f80",
   "description": "vona cli-set-api",
   "keywords": [
     "framework",
@@ -63,7 +63,7 @@
     "@rollup/plugin-typescript": "^12.3.0",
     "@swc-node/register": "^1.12.1",
     "babel-plugin-transform-typescript-metadata": "^0.3.2",
-    "babel-plugin-vona-bean-module": "^1.1.10",
+    "babel-plugin-vona-bean-module": "^1.1.11",
     "chalk": "^3.0.0",
     "cli-table3": "^0.6.5",
     "compressing": "^1.10.4",
@@ -77,7 +77,7 @@
     "rollup": "^4.60.1",
     "urllib": "^4.9.0",
     "uuid": "^11.1.0",
-    "vona-core": "^5.1.54",
+    "vona-core": "^5.1.56",
     "why-is-node-running": "^3.2.2",
     "yargs-parser": "^22.0.0"
   }