vome-core 0.3.68 → 0.3.70

package/dist/orm/entity-cache.d.ts

@@ -2,7 +2,7 @@
  * 实体行缓存：进程内 Map，不写 Redis。
  * token / 验证码等短键仍走宿主 CacheStore（Redis）。
  * 桶已加载才按 id 读写；桶不存在才执行 load 查库。
- * 启动灌桶：BaseService.init() 内 cacheSet；App.start 统一调用。
+ * 启动灌桶：BaseService.init() 内 cacheSet；App.start 后台调用，不阻塞 listen。
  */
 /**
  * 历史：宿主曾注入 Redis Hash。现已改为进程 Map，保留导出以免半截升级报错。

package/dist/orm/service.d.ts

@@ -12,8 +12,8 @@ import type { PageQuery, PageResult } from '../../typings/comm/page';
 export declare abstract class BaseService {
     protected entity?: Repository<any>;
     /**
-     * 启动灌本地实体缓存。App.start 在模块就绪后对全部单例 BaseService 调用。
-     * 需要热缓存时重写此方法，内部用 `cacheSet` 写库原行即可；默认空操作。
+     * 启动灌本地实体缓存。App.start 在模块就绪后后台调用，不阻塞 listen。
+     * 需要热缓存时重写此方法，内部 `await cacheSet` 写库原行即可；默认空操作。
      */
     init(): Promise<void>;
     /** IoC 注入时绑定主实体（仅首次） */
@@ -92,7 +92,7 @@ export declare abstract class BaseService {
     cacheDel(bucket: string, id?: number | string | Array<number | string>): Promise<void>;
 }
 /**
- * 启动时对全部单例 BaseService 调用 `init()`（内部用 cacheSet 灌桶）。
- * App.start 在模块 bootstrap 之后自动调用，宿主无需登记。
+ * 启动灌本地实体缓存：对全部单例 BaseService 调 `init()`（内部 cacheSet）。
+ * 不阻塞 App.start；全部写完后只打一条 `[localCache] success writing`。
  */
-export declare function initEntityCache(): Promise<void>;
+export declare function initEntityCache(): void;

package/dist/routing/context.d.ts

@@ -1,6 +1,7 @@
-import type { ControllerSide } from '../../typings/routing/meta';
+import type { AppChannel, AppClientChannel, ControllerSide } from '../../typings/routing/meta';
 import type { ControllerScanContext } from '../../typings/routing/scan-context';
 export type { ControllerScanContext };
+export type { AppChannel, AppClientChannel, ControllerSide };
 export declare function setControllerScanContext(next: ControllerScanContext | null): void;
 export declare function getControllerScanContext(): ControllerScanContext | null;
 /** modules/base/controller/admin/auth.ts → base */
@@ -9,6 +10,15 @@ export declare function parseModuleFromPath(file: string): string;
  * 未写 prefix 时由文件路径生成（相对 sidePrefix）
  * modules/base/controller/admin/auth.ts → /base/auth
  * modules/user/controller/app/rbac.ts → /user/rbac
+ * modules/shop/controller/app/store/goods.ts → /shop/store/goods（A1：路径保留 channel 段）
  */
 export declare function parseControllerAutoPrefix(file: string): string;
-export type { ControllerSide };
+/**
+ * 从 app 控制器路径推导通道。
+ * - `.../controller/app/store/**` → store
+ * - `.../controller/app/front/**` → front
+ * - 其余（含 `app/store.ts` 单文件）→ shared
+ */
+export declare function parseAppChannelFromPath(file: string): AppChannel;
+/** 解析客户端 EPS query：仅 store|front 有效 */
+export declare function normalizeAppClientChannel(raw: unknown): AppClientChannel | undefined;

package/dist/routing/eps.d.ts

@@ -1,4 +1,5 @@
 import type { EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, EpsPayload, EpsDictFlatRow } from '../../typings/routing/eps';
+import type { AppClientChannel } from '../../typings/routing/meta';
 import { listControllers } from './metadata';
 export type { EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, EpsPayload, EpsDictFlatRow, };
 /** 是否开启 EPS 下发（vome.eps === true） */
@@ -7,10 +8,12 @@ export declare function isEpsEnabled(): boolean;
  * EPS 接口元数据（按模块分组）
  * - admin → GET /admin/base/open/eps
  * - app → GET /app/base/open/eps
+ * - app + channel → GET /app/base/open/eps?channel=store|front（含 shared）
  */
 export declare const Eps: {
     controllers: typeof listControllers;
     admin: () => EpsModuleMap;
-    app: () => EpsModuleMap;
+    /** @param channel 传 store|front 时返回 shared + 该通道；省略则全量 app */
+    app: (channel?: AppClientChannel) => EpsModuleMap;
     enabled: typeof isEpsEnabled;
 };

package/dist/routing/index.d.ts

@@ -3,7 +3,8 @@ export type { EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, EpsPayload, EpsDic
 export { BaseController, RES_CODE } from './base';
 export type { ApiFail, ApiResult, ApiSuccess, ResCode } from './base';
 export { Controller, Get, Post, Put, Delete, Patch, Body, Query, Param, Public, Perms, IgnorePerms, Use, } from './decorators';
-export { listControllers, clearControllers, type ControllerMeta, type ControllerRouteMeta, type ControllerSide, type HttpMethod, type RouteParamMeta, type RouteParamSource, } from './metadata';
+export { parseAppChannelFromPath, normalizeAppClientChannel, } from './context';
+export { listControllers, clearControllers, type AppChannel, type AppClientChannel, type ControllerMeta, type ControllerRouteMeta, type ControllerSide, type HttpMethod, type RouteParamMeta, type RouteParamSource, } from './metadata';
 export { clearPublicRouteCache, collectPublicRouteKeys, isPublicHttpRoute, } from './public-routes';
 export type { ControllerCrudOptions, CrudApi, CrudBeforeFn, InsertParamFn, QueryExtendFn, QueryExtendQb, QueryFieldRef, QueryJoin, QueryJoinType, QueryOp, QueryOpCtx, QueryWhereFn, QueryWhereResult, RouteMiddleware, } from '../../typings/routing/crud';
 export type { CrudRegistrar } from './register';

package/dist/routing/metadata.d.ts

@@ -1,9 +1,13 @@
 import 'reflect-metadata';
 import type { ControllerCrudOptions, RouteMiddleware } from '../../typings/routing/crud';
-import type { ControllerMeta, ControllerRouteMeta, ControllerSide, HttpMethod, RouteParamMeta, RouteParamSource } from '../../typings/routing/meta';
-export type { ControllerMeta, ControllerRouteMeta, ControllerSide, HttpMethod, RouteParamMeta, RouteParamSource, };
+import type { AppChannel, AppClientChannel, ControllerMeta, ControllerRouteMeta, ControllerSide, HttpMethod, RouteParamMeta, RouteParamSource } from '../../typings/routing/meta';
+export type { AppChannel, AppClientChannel, ControllerMeta, ControllerRouteMeta, ControllerSide, HttpMethod, RouteParamMeta, RouteParamSource, };
 export declare function registerController(meta: ControllerMeta): void;
-export declare function listControllers(side?: ControllerSide): ControllerMeta[];
+/**
+ * @param side 可选侧过滤
+ * @param channel 仅对 side=app 生效：返回 shared + 指定通道（store|front）
+ */
+export declare function listControllers(side?: ControllerSide, channel?: AppClientChannel): ControllerMeta[];
 /** 同进程 restart 前清空，避免装饰器未重跑时残留旧清单 */
 export declare function clearControllers(): void;
 export declare function appendRouteParam(token: new (...args: unknown[]) => unknown, handler: string, param: RouteParamMeta): void;

package/dist/server/index.d.ts

@@ -5,7 +5,7 @@
  * 宿主须先 `import './config/provide'`，再 `import 'reflect-metadata'` / `./lib/host`。
  * 开启 `experimentalDecorators` + `emitDecoratorMetadata`。
  */
-export { App, appendInjectMeta, BaseController, Body, CommException, Context, Controller, Delete, Eps, isEpsEnabled, Get, getEnv, Inject, Ioc, isCommException, listControllers, clearControllers, isPublicHttpRoute, getProvider, listProviders, Logger, Param, Patch, Post, Provide, Public, Perms, IgnorePerms, Put, Query, RES_CODE, scanFiles, ScopeEnum, Use, vome, VomeConfig, registerHost, getHostBindings, DbStore, baseColumns, BASE_COLUMN_COMMENTS, entitySchemas, columnComments, getColumnComments, listColumnCommentTables, syncColumnCommentsToPg, Repository, getRepository, InjectRepository, BaseService, initEntityCache, registerEntityCacheStore, q, attachCrudRoutes, isTenantEnabled, normalizeHost, resolveTenantScope, registerTenantHostResolver, bindRequestTenant, tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, BasePlugin, loadPluginClass, loadPluginClassFromPath, loadModuleHandlers, loadModuleHandlersFromPath, readPluginScript, resolvePluginServerPath, pDataPath, pPluginPath, pModulesPath, pModulePath, pLicensesPath, pLicensePath, ModuleRegistry, microApps, createModuleGateway, defineAuthMacro, DEFAULT_MARKET_PUBLIC_KEY_B64, newMarketId, newInstallNonce, stableStringify, resolveMarketPublicKey, resolveMarketPrivateKey, ed25519Sign, ed25519Verify, generateMarketKeyPair, pricingFromPrice, buildMarketSigPayload, signMarketSigPayload, verifyMarketSigPayload, issueLicenseFile, parseLicenseFile, verifyLicenseFile, hashZipEntries, readZipManifest, readMarketSig, sealVomeBuffer, verifySealedVome, MARKET_LIC_ENTRY, readZipMarketLicense, attachMarketLicense, assertModuleInstallAllowed, assertModuleDirAllowed, peekMarketPackage, installModuleFromZip, uninstallModuleFiles, isSeatEnforced, isMarketSigEnforced, DEFAULT_SEAT_API_BASE, DEFAULT_LICENSE_ISSUE_URL, fetchOfficialSignedLicense, deriveHostIdentity, getHostIdentity, MARKET_SEAT_DEFAULTS, ensureSiteId, syncModuleSeat, syncAllModuleSeats, getModuleSeatStatus, listModuleSeatStatuses, isModuleSeatBlocked, assertModuleSeatActive, formatSeatDisplay, startMarketSeatHeartbeat, stopMarketSeatHeartbeat, bootstrapInstalledModules, } from '../core';
+export { App, appendInjectMeta, BaseController, Body, CommException, Context, Controller, Delete, Eps, isEpsEnabled, Get, getEnv, Inject, Ioc, isCommException, listControllers, clearControllers, isPublicHttpRoute, parseAppChannelFromPath, normalizeAppClientChannel, getProvider, listProviders, Logger, Param, Patch, Post, Provide, Public, Perms, IgnorePerms, Put, Query, RES_CODE, scanFiles, ScopeEnum, Use, vome, VomeConfig, registerHost, getHostBindings, DbStore, baseColumns, BASE_COLUMN_COMMENTS, entitySchemas, columnComments, getColumnComments, listColumnCommentTables, syncColumnCommentsToPg, Repository, getRepository, InjectRepository, BaseService, initEntityCache, registerEntityCacheStore, q, attachCrudRoutes, isTenantEnabled, normalizeHost, resolveTenantScope, registerTenantHostResolver, bindRequestTenant, tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, BasePlugin, loadPluginClass, loadPluginClassFromPath, loadModuleHandlers, loadModuleHandlersFromPath, readPluginScript, resolvePluginServerPath, pDataPath, pPluginPath, pModulesPath, pModulePath, pLicensesPath, pLicensePath, ModuleRegistry, microApps, createModuleGateway, defineAuthMacro, DEFAULT_MARKET_PUBLIC_KEY_B64, newMarketId, newInstallNonce, stableStringify, resolveMarketPublicKey, resolveMarketPrivateKey, ed25519Sign, ed25519Verify, generateMarketKeyPair, pricingFromPrice, buildMarketSigPayload, signMarketSigPayload, verifyMarketSigPayload, issueLicenseFile, parseLicenseFile, verifyLicenseFile, hashZipEntries, readZipManifest, readMarketSig, sealVomeBuffer, verifySealedVome, MARKET_LIC_ENTRY, readZipMarketLicense, attachMarketLicense, assertModuleInstallAllowed, assertModuleDirAllowed, peekMarketPackage, installModuleFromZip, uninstallModuleFiles, isSeatEnforced, isMarketSigEnforced, DEFAULT_SEAT_API_BASE, DEFAULT_LICENSE_ISSUE_URL, fetchOfficialSignedLicense, deriveHostIdentity, getHostIdentity, MARKET_SEAT_DEFAULTS, ensureSiteId, syncModuleSeat, syncAllModuleSeats, getModuleSeatStatus, listModuleSeatStatuses, isModuleSeatBlocked, assertModuleSeatActive, formatSeatDisplay, startMarketSeatHeartbeat, stopMarketSeatHeartbeat, bootstrapInstalledModules, } from '../core';
 export type { HostIdentity, HostBindings, HostLifecycle, HostSocket, HostMiddleware } from '../core';
 export { setControllerScanContext, parseModuleFromPath, } from '../routing/context';
 export { toPosixPath, normalizeScanPath } from '../comm/path';
@@ -21,6 +21,6 @@ export type { DataI18nRefDecl, DataI18nSeedItem } from '../i18n/entity-registry'
 export type { DataI18nFieldConfig, DataI18nFieldMode, DataI18nPackMap, DataI18nApplyContext, DataI18nApplier, } from '../i18n/data-i18n';
 export { resolveLangCodeFromRequest, getSourceLang, setSourceLang, isSourceLang, } from '../i18n/lang-code';
 export * from '../ai';
-export type { ApiFail, ApiResult, ApiSuccess, ClassToken, ContextData, ControllerCrudOptions, ControllerMeta, ControllerRouteMeta, ControllerSide, CrudApi, CrudBeforeFn, CrudRegistrar, CrudUpsertMode, CrudModifyType, CrudWriteOptions, CrudTrashQueryOptions, CrudDeleteOptions, CrudAddData, CrudUpdateWhere, CrudUpdatePatch, CrudIdOrIds, CrudDeleteWhere, CrudListWhere, CrudListOptions, CrudInfoWhere, CrudPageQuery, PageQuery, PagePagination, PageResult, PluginManifest, PluginInfo, PluginPayload, PluginCheckResult, ModuleRouteDef, ModuleMenuDef, ModuleManifest, ModuleHandlerCtx, ModuleHandler, ModuleInstalled, MarketPricing, MarketSigPayload, MarketLicensePayload, MarketLicenseFile, InstallGateKind, InstallGateResult, AssertModuleInstallOptions, InstallModuleOptions, InstallModuleResult, MarketSeatStatus, MarketSeatTicketPayload, MarketSeatTicket, EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, HttpMethod, InjectionToken, InjectMeta, InsertParamFn, ProvideOptions, QueryExtendFn, QueryExtendQb, QueryFieldRef, QueryJoin, QueryJoinType, QueryOp, QueryOpCtx, QueryWhereFn, QueryWhereResult, ResCode, RouteMiddleware, RouteParamMeta, RouteParamSource, ScanOptions, } from '../core';
+export type { ApiFail, ApiResult, ApiSuccess, ClassToken, ContextData, ControllerCrudOptions, AppChannel, AppClientChannel, ControllerMeta, ControllerRouteMeta, ControllerSide, CrudApi, CrudBeforeFn, CrudRegistrar, CrudUpsertMode, CrudModifyType, CrudWriteOptions, CrudTrashQueryOptions, CrudDeleteOptions, CrudAddData, CrudUpdateWhere, CrudUpdatePatch, CrudIdOrIds, CrudDeleteWhere, CrudListWhere, CrudListOptions, CrudInfoWhere, CrudPageQuery, PageQuery, PagePagination, PageResult, PluginManifest, PluginInfo, PluginPayload, PluginCheckResult, ModuleRouteDef, ModuleMenuDef, ModuleManifest, ModuleHandlerCtx, ModuleHandler, ModuleInstalled, MarketPricing, MarketSigPayload, MarketLicensePayload, MarketLicenseFile, InstallGateKind, InstallGateResult, AssertModuleInstallOptions, InstallModuleOptions, InstallModuleResult, MarketSeatStatus, MarketSeatTicketPayload, MarketSeatTicket, EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, HttpMethod, InjectionToken, InjectMeta, InsertParamFn, ProvideOptions, QueryExtendFn, QueryExtendQb, QueryFieldRef, QueryJoin, QueryJoinType, QueryOp, QueryOpCtx, QueryWhereFn, QueryWhereResult, ResCode, RouteMiddleware, RouteParamMeta, RouteParamSource, ScanOptions, } from '../core';
 /** 与 package.json version 同步 */
 export declare const version: string;