@nocobase/app-template-default 1.0.0-beta.71 → 1.0.0-beta.73

package/AGENTS.md

@@ -109,7 +109,7 @@ For any UI work, start with [the frontend workflow](.agents/skills/nocobase-app-
 
 `client/routing/`, `client/layouts/`, `client/theme/`, the server entry points, the `package.json` scripts that call `nocobase`, and the tsconfigs are the scaffolding the template provides. It is still this application's own source — it shipped to the user and they may change it — but it is the part the template evolves, so an edit there is what a future upgrade has to reconcile.
 
-Prefer the mechanism the system already provides. Declare a page in `client/routes.ts` and add `navigation` when it needs a menu entry. Refine resources add no menu entries and, with no data provider registered, load nothing; pages load data through `useApiClient`. A page uses `authz` to restrict access; a plugin page is customized through an option or an override. Before editing the shell to add a menu, check the route and its `navigation` declaration.
+Prefer the mechanism the system already provides. Declare a page in `client/routes.ts` and add `navigation` when it needs a menu entry; pages load data through `useApiClient`. A page uses `authz` to restrict access; a plugin page is customized through an option or an override. Before editing the shell to add a menu, check the route and its `navigation` declaration.
 
 When the built-in mechanism genuinely cannot express what is being asked, changing this structure is a legitimate answer — not a last resort to apologize for. Do it deliberately, and leave the next agent enough to work with:
 

package/README.MD

@@ -1,6 +1,6 @@
 # NocoBase 3 Application
 
-A full-stack NocoBase 3 application. The server runs on `@nocobase/app-server` and the browser client is React with Refine, shadcn/ui, and Tailwind CSS.
+A full-stack NocoBase 3 application. The server runs on `@nocobase/app-server` and the browser client is React with shadcn/ui and Tailwind CSS.
 
 You own everything in this directory. Add pages, API routes, database tables, and business logic directly here — this is your application's source code, not a framework you extend from the outside.
 

package/client/service-provider.ts

@@ -19,7 +19,6 @@ export class DefaultClientServiceProvider extends ServiceProvider<ClientApplicat
       typeof configuredTitle === 'string' && configuredTitle.trim()
         ? configuredTitle.trim()
         : 'NocoBase';
-    this.app.refine.setOptions({ title: { text: title } });
     this.previousDocumentTitle = document.title;
     document.title = title;
     return Promise.resolve();

package/config.example.yml

@@ -22,6 +22,26 @@
 #     max: 600
 #     window: 1m
 
+# Realtime events are transient and local to this process. Clients refetch after subscription acknowledgement.
+# realtime:
+#   adapter: inMemory # Use redis for multiple application processes.
+#   redis:
+#     connection:
+#       host: 127.0.0.1
+#       port: 6379
+#   namespace: my-app # Defaults to the application name; keep applications isolated.
+#   authorizationTimeoutMs: 5000
+#   sessionCheckIntervalMs: 30000
+#   limits:
+#     maxConcurrentAuthorizations: 256
+#     maxPendingAuthorizations: 2048
+#     maxRecentEventIds: 10000
+#     maxConnections: 10000
+#     maxMessageBytes: 65536
+#     maxSubscriptionsPerConnection: 64
+#     maxBufferedBytesPerConnection: 1048576
+#     maxPendingMessagesPerConnection: 64
+
 # Values under client are public and embedded in the SPA HTML.
 client:
   app:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nocobase/app-template-default",
   "displayName": "Default Template",
-  "version": "1.0.0-beta.71",
+  "version": "1.0.0-beta.73",
   "type": "module",
   "prettier": "@nocobase/dev-config/prettier",
   "engines": {
@@ -9,19 +9,14 @@
   },
   "nocobase": {
     "templateKind": "app",
-    "defaultTemplateVersion": "1.0.0-beta.71"
+    "defaultTemplateVersion": "1.0.0-beta.73"
   },
   "devDependencies": {
-    "@ai-sdk/react": "2.0.0",
+    "@ai-sdk/react": "4.0.131",
     "@base-ui/react": "^1.6.0",
     "@dicebear/core": "^9.4.3",
     "@hookform/resolvers": "^5.0.1",
     "@playwright/test": "^1.62.1",
-    "@refinedev/cli": "^2.16.48",
-    "@refinedev/core": "^5.0.8",
-    "@refinedev/react-hook-form": "^5.0.0",
-    "@refinedev/react-router": "^2.0.0",
-    "@refinedev/react-table": "^6.0.0",
     "@silurus/ooxml": "0.85.1",
     "@tailwindcss/postcss": "^4.1.4",
     "@tailwindcss/vite": "^4.1.8",
@@ -42,7 +37,7 @@
     "@types/react-dom": "^19.2.0",
     "@vitejs/plugin-react": "^4.4.1",
     "@vitest/coverage-v8": "^4.1.10",
-    "ai": "5.0.0",
+    "ai": "7.0.128",
     "class-variance-authority": "^0.7.1",
     "cn": "^0.4.0",
     "dayjs": "^1.10.7",
@@ -77,12 +72,12 @@
     "tar": "^7.5.22",
     "@xyflow/react": "^12.11.5",
     "elkjs": "^0.10.2",
-    "@nocobase/app-client": "^3.0.0-beta.2",
+    "@nocobase/app-client": "^4.0.0-beta.0",
     "@nocobase/app-plugin-template-print": "0.0.2-beta.2",
-    "@nocobase/app-skills": "0.1.0-beta.39",
-    "@nocobase/app-testing": "0.1.0-beta.4",
-    "@nocobase/app-websocket": "^0.0.2-beta.0",
-    "@nocobase/dev-config": "0.1.0-beta.23",
+    "@nocobase/app-skills": "0.1.0-beta.41",
+    "@nocobase/app-testing": "0.1.0-beta.5",
+    "@nocobase/app-websocket": "^0.1.0-beta.1",
+    "@nocobase/dev-config": "0.1.0-beta.24",
     "@nocobase/drive": "^0.1.0-beta.7",
     "@nocobase/logging": "^0.1.0-beta.7",
     "@nocobase/session": "^0.1.0-beta.3"
@@ -144,35 +139,37 @@
     "@oclif/core": "^4.14.0",
     "better-auth": "1.7.5",
     "hono": "^4.13.2",
-    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.17",
-    "@nocobase/app-plugin-authentication": "^2.0.0-beta.10",
-    "@nocobase/app-plugin-authorization": "^1.0.0-beta.28",
-    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.15",
-    "@nocobase/app-plugin-file": "^1.0.0-beta.24",
-    "@nocobase/app-plugin-i18n": "^1.0.0-beta.16",
-    "@nocobase/app-plugin-mail": "^1.0.0-beta.14",
-    "@nocobase/app-plugin-notification": "^1.0.0-beta.27",
-    "@nocobase/app-plugin-notification-in-app": "^1.0.0-beta.25",
-    "@nocobase/app-plugin-notification-providers": "^0.2.0-beta.12",
-    "@nocobase/app-plugin-scheduler": "^1.0.0-beta.17",
-    "@nocobase/app-plugin-users": "^2.0.0-beta.5",
-    "@nocobase/app-server": "^2.0.0-beta.9",
+    "@nocobase/app-plugin-agents": "^1.0.0-beta.15",
+    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.18",
+    "@nocobase/app-plugin-authentication": "^2.0.0-beta.11",
+    "@nocobase/app-plugin-authorization": "^1.0.0-beta.29",
+    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.16",
+    "@nocobase/app-plugin-file": "^1.0.0-beta.25",
+    "@nocobase/app-plugin-i18n": "^1.0.0-beta.17",
+    "@nocobase/app-plugin-mail": "^1.0.0-beta.15",
+    "@nocobase/app-plugin-notification": "^1.0.0-beta.28",
+    "@nocobase/app-plugin-notification-in-app": "^1.0.0-beta.26",
+    "@nocobase/app-plugin-notification-providers": "^0.2.0-beta.13",
+    "@nocobase/app-plugin-scheduler": "^1.0.0-beta.18",
+    "@nocobase/app-plugin-users": "^2.0.0-beta.6",
+    "@nocobase/app-server": "^3.0.0-beta.0",
     "@nocobase/config": "^0.1.0-beta.3",
     "@nocobase/db": "^1.0.0-beta.21",
     "@nocobase/db-sqlite": "^0.1.0-beta.6",
     "@nocobase/service-provider": "^0.0.2-beta.2",
     "@nocobase/snowflake": "^1.0.0-beta.4",
-    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.13",
-    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.13",
-    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.12",
+    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.14",
+    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.14",
+    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.13",
     "@nocobase/authorization": "^1.0.0-beta.14",
     "@nocobase/queue": "^0.1.0-beta.9",
     "@nocobase/jobs": "^0.1.0-beta.3",
-    "@nocobase/lifecycle": "^0.1.0-beta.2",
-    "@nocobase/i18n": "^1.0.0-beta.7",
+    "@nocobase/lifecycle": "^0.1.0-beta.3",
+    "@nocobase/i18n": "^2.0.0-beta.0",
     "@nocobase/caching": "^0.1.0-beta.3",
     "@nocobase/repository-input": "^0.1.0-beta.3",
-    "@nocobase/app-cli": "^1.0.0-beta.24"
+    "@nocobase/app-cli": "^1.0.0-beta.25",
+    "@nocobase/realtime": "^0.1.0-beta.3"
   },
   "description": "NocoBase 3 application template with the standard product capabilities.",
   "imports": {

package/tests/components/app-title.test.tsx

@@ -17,9 +17,6 @@ describe('application title', () => {
 
     await app.start();
 
-    expect(app.refineConfig.options?.title).toEqual({
-      text: 'Configured application',
-    });
     expect(document.title).toBe('Configured application');
 
     await app.shutdown();
@@ -33,7 +30,6 @@ describe('application title', () => {
 
     await app.start();
 
-    expect(app.refineConfig.options?.title).toEqual({ text: 'NocoBase' });
     expect(document.title).toBe('NocoBase');
 
     await app.shutdown();

package/tests/components/inbox.test.tsx

@@ -20,7 +20,11 @@ vi.mock('@nocobase/app-plugin-authentication/client', () => ({
 vi.mock('@nocobase/app-client', async (importOriginal) => {
   const actual = await importOriginal<typeof import('@nocobase/app-client')>();
   const client = { request: mocks.request };
-  const realtime = { subscribe: () => vi.fn(), onOpen: () => vi.fn() };
+  const realtime = {
+    watch: () => ({ close: vi.fn() }),
+    subscribe: () => vi.fn(),
+    onOpen: () => vi.fn(),
+  };
   return {
     ...actual,
     useApiClient: () => client,

package/tests/fixtures/theme-tokens.tsx

@@ -2,7 +2,6 @@ import {
   createAppSidebarPreferenceStore,
   SidebarPreferenceProvider,
 } from '../../client/layouts/use-sidebar-preference.js';
-import { Refine } from '@refinedev/core';
 import { createRoot } from 'react-dom/client';
 import { MemoryRouter } from 'react-router';
 import { Loading } from '../../client/components/loading';
@@ -28,90 +27,88 @@ export default function Fixture() {
   return (
     <MemoryRouter>
       <AppThemeProvider>
-        <Refine options={{ disableTelemetry: true }}>
-          <AppSidebarProvider>
-            <AppSidebar label='Fixture sidebar'>
-              <div className='p-2'>
-                <Input aria-label='Sidebar content' />
-              </div>
-            </AppSidebar>
-            <main className='min-w-0 flex-1 space-y-6 overflow-y-auto p-6'>
-              <div className='flex flex-wrap gap-2'>
-                <ThemeSettings />
-                <AppSidebarToggle />
-              </div>
-              <h1 className='text-3xl'>Theme tokens · 主题样式</h1>
-              <section
-                className='flex h-32 items-center justify-center rounded-lg border bg-background'
-                aria-label='Brand loading preview'
-              >
-                <Loading label='Loading preview' />
-              </section>
-              <p data-testid='body'>Body text · 中文内容与 English text</p>
-              <p className='font-serif'>Serif text</p>
-              <code>const theme = 'compact';</code>
-              <div className='flex flex-wrap gap-2'>
-                <Button>Default action</Button>
-                <Button size='sm'>Small action</Button>
-                <Button size='xs'>Extra small</Button>
-                <Button variant='destructive'>Delete</Button>
-              </div>
-              <Input
-                aria-label='Example input'
-                placeholder='输入内容 / Enter text'
-              />
-              <Popover>
-                <PopoverTrigger render={<Button variant='outline' />}>
-                  Open popover
-                </PopoverTrigger>
-                <PopoverContent>
-                  <PopoverTitle>Portal heading</PopoverTitle>
-                  <p>Portal body · 浮层内容</p>
-                </PopoverContent>
-              </Popover>
-              <section className='rounded-xl border bg-card p-4 text-card-foreground shadow-md ring-1 ring-ring'>
-                <h2 className='text-xl'>Card heading</h2>
-                <p className='text-sm'>
-                  A long description that wraps without clipping when fonts and
-                  spacing change. 长文本应该正常换行，不应被控件裁切。
-                </p>
-              </section>
-              <svg
-                aria-label='Chart palette'
-                viewBox='0 0 120 30'
-                className='h-8'
-              >
-                {[1, 2, 3, 4, 5].map((i) => (
-                  <rect
-                    key={i}
-                    x={(i - 1) * 24}
-                    width='20'
-                    height='30'
-                    fill={`var(--chart-${i})`}
-                  />
-                ))}
-              </svg>
-              <div className='flex flex-wrap gap-2'>
-                <div className='rounded-sm border p-2'>sm</div>
-                <div className='rounded-md border p-2'>md</div>
-                <div className='rounded-lg border p-2'>lg</div>
-                <div className='rounded-xl border p-2'>xl</div>
-                <div className='rounded-2xl border p-2'>2xl</div>
-                <div className='rounded-3xl border p-2'>3xl</div>
-                <div className='rounded-4xl border p-2'>4xl</div>
-              </div>
-              <div className='flex flex-wrap gap-4'>
-                <div className='shadow-2xs p-2'>2xs</div>
-                <div className='shadow-xs p-2'>xs</div>
-                <div className='shadow-sm p-2'>sm</div>
-                <div className='shadow-md p-2'>md</div>
-                <div className='shadow-lg p-2'>lg</div>
-                <div className='shadow-xl p-2'>xl</div>
-                <div className='shadow-2xl p-2'>2xl</div>
-              </div>
-            </main>
-          </AppSidebarProvider>
-        </Refine>
+        <AppSidebarProvider>
+          <AppSidebar label='Fixture sidebar'>
+            <div className='p-2'>
+              <Input aria-label='Sidebar content' />
+            </div>
+          </AppSidebar>
+          <main className='min-w-0 flex-1 space-y-6 overflow-y-auto p-6'>
+            <div className='flex flex-wrap gap-2'>
+              <ThemeSettings />
+              <AppSidebarToggle />
+            </div>
+            <h1 className='text-3xl'>Theme tokens · 主题样式</h1>
+            <section
+              className='flex h-32 items-center justify-center rounded-lg border bg-background'
+              aria-label='Brand loading preview'
+            >
+              <Loading label='Loading preview' />
+            </section>
+            <p data-testid='body'>Body text · 中文内容与 English text</p>
+            <p className='font-serif'>Serif text</p>
+            <code>const theme = 'compact';</code>
+            <div className='flex flex-wrap gap-2'>
+              <Button>Default action</Button>
+              <Button size='sm'>Small action</Button>
+              <Button size='xs'>Extra small</Button>
+              <Button variant='destructive'>Delete</Button>
+            </div>
+            <Input
+              aria-label='Example input'
+              placeholder='输入内容 / Enter text'
+            />
+            <Popover>
+              <PopoverTrigger render={<Button variant='outline' />}>
+                Open popover
+              </PopoverTrigger>
+              <PopoverContent>
+                <PopoverTitle>Portal heading</PopoverTitle>
+                <p>Portal body · 浮层内容</p>
+              </PopoverContent>
+            </Popover>
+            <section className='rounded-xl border bg-card p-4 text-card-foreground shadow-md ring-1 ring-ring'>
+              <h2 className='text-xl'>Card heading</h2>
+              <p className='text-sm'>
+                A long description that wraps without clipping when fonts and
+                spacing change. 长文本应该正常换行，不应被控件裁切。
+              </p>
+            </section>
+            <svg
+              aria-label='Chart palette'
+              viewBox='0 0 120 30'
+              className='h-8'
+            >
+              {[1, 2, 3, 4, 5].map((i) => (
+                <rect
+                  key={i}
+                  x={(i - 1) * 24}
+                  width='20'
+                  height='30'
+                  fill={`var(--chart-${i})`}
+                />
+              ))}
+            </svg>
+            <div className='flex flex-wrap gap-2'>
+              <div className='rounded-sm border p-2'>sm</div>
+              <div className='rounded-md border p-2'>md</div>
+              <div className='rounded-lg border p-2'>lg</div>
+              <div className='rounded-xl border p-2'>xl</div>
+              <div className='rounded-2xl border p-2'>2xl</div>
+              <div className='rounded-3xl border p-2'>3xl</div>
+              <div className='rounded-4xl border p-2'>4xl</div>
+            </div>
+            <div className='flex flex-wrap gap-4'>
+              <div className='shadow-2xs p-2'>2xs</div>
+              <div className='shadow-xs p-2'>xs</div>
+              <div className='shadow-sm p-2'>sm</div>
+              <div className='shadow-md p-2'>md</div>
+              <div className='shadow-lg p-2'>lg</div>
+              <div className='shadow-xl p-2'>xl</div>
+              <div className='shadow-2xl p-2'>2xl</div>
+            </div>
+          </main>
+        </AppSidebarProvider>
       </AppThemeProvider>
     </MemoryRouter>
   );

package/tests/logic/app-server.test.ts

@@ -423,12 +423,13 @@ describe('app server', () => {
     expect(missingEvents).toBeNull();
   });
 
-  it('subscribes, publishes, and unsubscribes realtime messages', () => {
+  it('subscribes, publishes, and unsubscribes realtime messages', async () => {
     const realtime = createRealtimeService();
+    realtime.registerTopic(TEST_REALTIME_TOPIC, { audience: 'public' });
     const websocket = createTestWebSocket();
     const connection = realtime.connect(websocket);
 
-    realtime.handleClientMessage(
+    await realtime.handleClientMessage(
       connection,
       JSON.stringify({
         type: 'subscribe',
@@ -445,7 +446,7 @@ describe('app server', () => {
       subscriptionId: expect.any(String),
     });
 
-    realtime.publish(TEST_REALTIME_TOPIC, 'tick');
+    await realtime.publish(TEST_REALTIME_TOPIC, 'tick');
 
     expect(websocket.messages[1]).toMatchObject({
       type: 'event',
@@ -454,7 +455,7 @@ describe('app server', () => {
       publishedAt: expect.any(String),
     });
 
-    realtime.handleClientMessage(
+    await realtime.handleClientMessage(
       connection,
       JSON.stringify({
         type: 'unsubscribe',
@@ -463,7 +464,7 @@ describe('app server', () => {
           .subscriptionId,
       }),
     );
-    realtime.publish(TEST_REALTIME_TOPIC, 'after unsubscribe');
+    await realtime.publish(TEST_REALTIME_TOPIC, 'after unsubscribe');
 
     expect(websocket.messages[2]).toMatchObject({
       type: 'unsubscribed',
@@ -473,7 +474,7 @@ describe('app server', () => {
     });
     expect(websocket.messages).toHaveLength(3);
 
-    realtime.close();
+    await realtime.close();
   });
 
   it('registers embedded app resources with the scope', async () => {
@@ -791,6 +792,9 @@ describe('app server', () => {
     const app = trackCloseable(
       await createIsolatedStandaloneServer({ viteDevUrl: false }),
     );
+    app.application.container
+      .resolve(realtimeServiceToken)
+      .registerTopic(TEST_REALTIME_TOPIC, { audience: 'public' });
     const serverUrl = await startStandaloneTestServer(app);
     const websocket = new WebSocket(
       `${serverUrl}${app.application.publicBasePath}/ws`,

package/tests/logic/client-runtime.test.ts

@@ -1,6 +1,6 @@
 import { createApp } from '../../client/app.js';
 import { ServiceProvider } from '@nocobase/service-provider';
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it } from 'vitest';
 
 import { ClientApplication, toasterToken } from '@nocobase/app-client';
 import {
@@ -47,19 +47,18 @@ describe('app client runtime', () => {
     expect(calls).toEqual([]);
   });
 
-  it('runs provider lifecycle and exposes Refine config through ClientApplication', async () => {
-    const authProvider = {
-      check: vi.fn(),
-      getIdentity: vi.fn(),
-      login: vi.fn(),
-      logout: vi.fn(),
-      onError: vi.fn(),
-    };
+  it('runs provider lifecycle through ClientApplication', async () => {
+    const calls: string[] = [];
     class Provider extends ServiceProvider<ClientApplicationType> {
       public readonly name: string = '@example/provider';
 
       public override boot(): Promise<void> {
-        this.app.refine.setAuthProvider(authProvider);
+        calls.push('boot');
+        return Promise.resolve();
+      }
+
+      public override shutdown(): Promise<void> {
+        calls.push('shutdown');
         return Promise.resolve();
       }
     }
@@ -77,8 +76,9 @@ describe('app client runtime', () => {
     });
 
     await app.start();
-    expect(app.refineConfig.authProvider).toBe(authProvider);
+    expect(calls).toEqual(['boot']);
     await app.shutdown();
+    expect(calls).toEqual(['boot', 'shutdown']);
   });
 
   it('uses the default template Application and static plugin declarations', async () => {
@@ -90,16 +90,12 @@ describe('app client runtime', () => {
     expect(app).toBeInstanceOf(ClientApplication);
     await expect(app.start()).resolves.toBeUndefined();
     expect(app.config.get('app.title')).toBe('Configured application');
-    expect(app.refineConfig.options?.title).toEqual({
-      text: 'Configured application',
-    });
     // Plugins and pages report through the registered toaster, and the mounted Toaster renders what it forwards.
     // Without either half, toasts disappear.
     expect(app.services.has(toasterToken)).toBe(true);
     expect(runtime.reactProviders).toContainEqual(
       expect.objectContaining({ name: 'toaster', layer: 'application' }),
     );
-    expect(app.refineConfig.resources ?? []).toEqual([]);
     await app.shutdown();
   });
 

package/vitest.config.ts

@@ -11,12 +11,13 @@ export default createReactVitestConfig({
       deps: {
         // Transform the public Client surfaces so vi.mock applies, without duplicating the Server packages' identity tokens.
         inline: [
-          // The authentication guards read the location, so they share the test's react-router rather than Node's copy,
-          // together with every client that resolves the authentication tokens and provider.
-          /@nocobase\/app-plugin-(?:authentication|api-keys|users)\/(?:dist\/)?client\//u,
-          /@nocobase\/app-plugin-authorization\/(?:dist\/)?client\//u,
-          /@nocobase\/app-plugin-(?:lifecycle-example|office-flows-example)\/(?:dist\/)?client\//u,
-          /@nocobase\/app-plugin-notification-in-app\/(?:dist\/)?client\//u,
+          // The published fixture mounts MemoryRouter; transform it with the page to share the router context.
+          /@nocobase\/app-testing\/(?:dist\/)?src\/client\//u,
+          // AppClientProviders includes the navigation guard and must use that same router context.
+          /@nocobase\/app-client\//u,
+          // Every client plugin that resolves AppClient tokens must share the transformed runtime.
+          // Keep server/shared modules external so their service identities remain unchanged.
+          /@nocobase\/app-plugin-[^/]+\/(?:dist\/)?client\//u,
         ],
       },
     },