@ximatai/muyun-web-app 0.26.8 → 0.26.10

package/dist/types/web-core/module/moduleContext.d.ts

@@ -1,21 +1,23 @@
 import type { HttpClient } from '../http';
 import { type ModuleAbilities } from './abilities';
 import { type ModuleActionState, type ModuleRecordActionAvailability, type ModuleRuntimeAction, type ModuleRuntimeContextState } from './runtimeContext';
-import { type StaticModuleCrudClient, type StaticModuleTreeClient } from './staticModuleClient';
+import { type NavigatorReferenceRequestContext, type ModuleCrudClient, type ModuleTreeClient } from './staticModuleClient';
 export interface ModuleContext<TRecord> {
     moduleAlias: string;
     http: HttpClient;
-    crud: StaticModuleCrudClient<TRecord>;
+    crud: ModuleCrudClient<TRecord>;
     runtime: ModuleRuntimeContextState;
     abilities: ModuleAbilities<TRecord>;
     action(actionCode: string, recordId?: string): ModuleActionState | undefined;
     runtimeAction(actionCode: string): ModuleRuntimeAction | undefined;
     can(actionCode: string, recordId?: string): boolean | undefined;
     recordActions(recordId: string): Promise<ModuleRecordActionAvailability>;
+    recordActionsBatch?(recordIds: string[]): Promise<ModuleRecordActionAvailability[]>;
     recordActionsSnapshot(recordId: string): ModuleRecordActionAvailability | undefined;
+    invalidateRecordActions?(recordIds?: string[]): void;
 }
 export interface ModuleTreeContext<TRecord> extends ModuleContext<TRecord> {
-    tree: StaticModuleTreeClient<TRecord>;
+    tree: ModuleTreeClient<TRecord>;
 }
 export interface ModuleContextConfig {
     http?: HttpClient;
@@ -24,6 +26,7 @@ export interface ModuleContextConfig {
 export interface ModuleContextOptions extends ModuleContextConfig {
     moduleAlias: string;
     runtimeAccess?: 'MENU' | 'REFERENCE';
+    navigatorReference?: NavigatorReferenceRequestContext;
 }
 export declare function configureModuleContext(config: ModuleContextConfig): void;
 export declare function provideModuleContextConfig(config: ModuleContextConfig): void;

package/dist/types/web-core/module/runtimeContext.d.ts

@@ -61,7 +61,9 @@ export interface ModuleRuntimeContextState {
     runtimeAction(actionCode: string): ModuleRuntimeAction | undefined;
     can(actionCode: string, recordId?: string): boolean | undefined;
     recordActions(recordId: string): Promise<ModuleRecordActionAvailability>;
+    recordActionsBatch?(recordIds: string[]): Promise<ModuleRecordActionAvailability[]>;
     recordActionsSnapshot(recordId: string): ModuleRecordActionAvailability | undefined;
+    invalidateRecordActions?(recordIds?: string[]): void;
 }
 export declare function createModuleRuntimeContextState(http: HttpClient, moduleAlias: string, access?: 'MENU' | 'REFERENCE'): ModuleRuntimeContextState;
 export declare function isRuntimeAbilityAvailable(context: ModuleRuntimeContext | undefined, ability: ModuleAbilityCode): boolean;

package/dist/types/web-core/module/staticModuleClient.d.ts

@@ -11,7 +11,8 @@ export interface QuerySchemaRequestOptions {
     uiConfigId?: string;
     queryTemplateId?: string;
 }
-export interface StaticModuleCrudClient<TRecord> {
+/** Source-neutral client for a platform module's standard CRUD contract. */
+export interface ModuleCrudClient<TRecord> {
     querySchema(options?: QuerySchemaRequestOptions): Promise<QuerySchema>;
     query(request?: WebQueryRequest): Promise<WebPageResponse<TRecord>>;
     view(id: string): Promise<TRecord>;
@@ -21,7 +22,8 @@ export interface StaticModuleCrudClient<TRecord> {
     enable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
     disable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
 }
-export interface StaticModuleTreeClient<TRecord> extends StaticModuleCrudClient<TRecord> {
+/** Source-neutral tree extension for a platform module. */
+export interface ModuleTreeClient<TRecord> extends ModuleCrudClient<TRecord> {
     tree(request?: WebQueryRequest): Promise<WebListResponse<WebTreeNode<TRecord>>>;
     treeFlat(options?: {
         rootId?: string;
@@ -36,18 +38,48 @@ export interface ModuleEnableClient {
     enable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
     disable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
 }
-export declare function createStaticModuleCrudClient<TRecord>(http: HttpClient, options: {
+/**
+ * Fixed platform transport for a compiled, one-level detail relation.
+ * Relation descriptors contain no business URL: the parent module alias, persisted parent id and
+ * server-issued relation code are the only routing facts a surface receives.
+ */
+export interface ManagedDetailRelationClient<TRecord> {
+    query(request?: WebQueryRequest): Promise<WebPageResponse<TRecord>>;
+    insert(record: TRecord): Promise<StaticRecordMutationResult<TRecord>>;
+    update(id: string, record: TRecord): Promise<StaticRecordMutationResult<TRecord>>;
+    delete(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
+}
+export declare function createManagedDetailRelationClient<TRecord>(http: HttpClient, options: {
+    parentModuleAlias: string;
+    parentId: string;
+    relationCode: string;
+}): ManagedDetailRelationClient<TRecord>;
+export declare function createModuleCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
-}): StaticModuleCrudClient<TRecord>;
+}): ModuleCrudClient<TRecord>;
 /** The navigation-only read surface deliberately does not reuse the module query endpoint. */
 export declare function createNavigatorReferenceCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
-}): StaticModuleCrudClient<TRecord>;
-export declare function createStaticResourceCrudClient<TRecord>(http: HttpClient, resourcePath: string): StaticModuleCrudClient<TRecord>;
-export declare function createStaticModuleTreeClient<TRecord>(http: HttpClient, options: {
+    navigatorReference?: NavigatorReferenceRequestContext;
+}): ModuleCrudClient<TRecord>;
+export declare function createStaticResourceCrudClient<TRecord>(http: HttpClient, resourcePath: string): ModuleCrudClient<TRecord>;
+export declare function createModuleTreeClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
-}): StaticModuleTreeClient<TRecord>;
+}): ModuleTreeClient<TRecord>;
 export declare function createNavigatorReferenceTreeClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
-}): StaticModuleTreeClient<TRecord>;
-export declare function createStaticResourceTreeClient<TRecord>(http: HttpClient, resourcePath: string): StaticModuleTreeClient<TRecord>;
+    navigatorReference?: NavigatorReferenceRequestContext;
+}): ModuleTreeClient<TRecord>;
+export interface NavigatorReferenceRequestContext {
+    hostModuleAlias: string;
+    targetLevelKey: string;
+}
+export declare function createStaticResourceTreeClient<TRecord>(http: HttpClient, resourcePath: string): ModuleTreeClient<TRecord>;
+/** @deprecated Use ModuleCrudClient. Remove after static-prefixed consumer imports migrate. */
+export type StaticModuleCrudClient<TRecord> = ModuleCrudClient<TRecord>;
+/** @deprecated Use ModuleTreeClient. Remove after static-prefixed consumer imports migrate. */
+export type StaticModuleTreeClient<TRecord> = ModuleTreeClient<TRecord>;
+/** @deprecated Use createModuleCrudClient. Remove after static-prefixed consumer imports migrate. */
+export declare const createStaticModuleCrudClient: typeof createModuleCrudClient;
+/** @deprecated Use createModuleTreeClient. Remove after static-prefixed consumer imports migrate. */
+export declare const createStaticModuleTreeClient: typeof createModuleTreeClient;

package/dist/types/web-core/realtime.d.ts

@@ -23,8 +23,16 @@ export interface RealtimeClient {
     state(): RealtimeConnectionState;
 }
 export interface RealtimeClientOptions {
+    /**
+     * Backend API base URL. The default WebSocket endpoint is resolved relative
+     * to this path, so an API mounted at `/api` connects to `/api/ws/platform`.
+     */
     baseUrl?: string;
     token?: string;
+    /**
+     * WebSocket endpoint relative to {@link baseUrl}. A root-relative or
+     * absolute URL remains an explicit override for deployments that need it.
+     */
     brokerPath?: string;
     reconnectDelay?: number;
     heartbeatIncoming?: number;

package/dist/types/web-core/referenceResolveClient.d.ts

@@ -0,0 +1,11 @@
+import type { WebReferenceResolveRequest, WebReferenceResolveResponse } from '../web-contracts/index';
+import type { HttpClient } from './http';
+/**
+ * Resolves candidates for a source field, including source-defined filtering,
+ * projections and field patches. The transport is source-module based; callers
+ * must not derive it from the referenced target module.
+ */
+export interface ReferenceResolveClient {
+    resolve(fieldName: string, request?: WebReferenceResolveRequest): Promise<WebReferenceResolveResponse>;
+}
+export declare function createReferenceResolveClient(http: HttpClient, moduleAlias: string, resolvePath?: string): ReferenceResolveClient;