vome-core 0.3.56 → 0.3.57

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

@@ -0,0 +1,23 @@
+/**
+ * 实体行缓存：Redis 为重启后的来源，进程内再留一份，热路径不打 Redis。
+ * 只有 Redis 和进程都没有时，才由调用方查库并写入。
+ */
+type EntityCacheIo = {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+};
+export declare function registerEntityCacheStore(store: EntityCacheIo | null): void;
+/** 全部行；Redis 没有且提供了 load 才查库 */
+export declare function entityCacheGet<T>(bucket: string, load?: () => Promise<T[]>): Promise<T[]>;
+/** 按 id 取一行。缓存未建立时先走 get（可查库） */
+export declare function entityCacheGetById<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;
+/**
+ * 写入。
+ * 数组：整桶替换。
+ * 单条：按 id 合并进已有缓存。缓存还没有时不写残缺行，等下次 get 从库装全量。
+ */
+export declare function entityCacheSet(bucket: string, data: unknown): Promise<void>;
+/** 删整桶，或按 id 删行 */
+export declare function entityCacheDel(bucket: string, id?: number | string | Array<number | string>): Promise<void>;
+export {};

package/dist/orm/index.d.ts

@@ -16,10 +16,11 @@ export { registerOnForceDelete, clearForceDeleteHooks, runOnForceDelete, } from
 export type { ForceDeleteHook, ForceDeleteHookEvent, } from './force-delete-hooks';
 export { listUniqueKeySets, buildUniqueWhere, buildUniqueWhereForRows, uniqueFingerprint, } from './unique-keys';
 export { BaseService } from './service';
+export { registerEntityCacheStore } from './entity-cache';
 export { q, compactWhere, needsAdvancedQuery, buildQueryOp } from './query-op';
 export { queryWithOp } from './query-builder';
 export { attachCrudRoutes } from './crud-register';
-export { isTenantEnabled, tableHasTenantId, resolveTenantScope, applyTenantWhere, stampTenantId, noTenant, normalizeHost, } from './tenant';
+export { isTenantEnabled, tableHasTenantId, resolveTenantScope, applyTenantWhere, stampTenantId, registerTenantHostResolver, bindRequestTenant, noTenant, normalizeHost, } from './tenant';
 export { tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, noDataScope, } from './data-scope';
 export type { CrudUpsertMode, CrudModifyType, CrudWriteOptions, CrudTrashQueryOptions, CrudDeleteOptions, CrudAddData, CrudUpdateWhere, CrudUpdatePatch, CrudIdOrIds, CrudDeleteWhere, CrudListWhere, CrudListOptions, CrudInfoWhere, CrudPageQuery, } from '../../typings/comm/crud';
 export type { PageQuery, PagePagination, PageResult, } from '../../typings/comm/page';

package/dist/orm/service.d.ts

@@ -71,4 +71,16 @@ export declare abstract class BaseService {
         where?: SQL | undefined;
         orderBy?: SQL[];
     } & CrudTrashQueryOptions): Promise<PageResult>;
+    /**
+     * 行缓存。Redis 有则直接用，没有才执行 load 查库并写入。
+     * 省略 id 返回全部；传入 id 只取那一行。
+     */
+    cacheGet<T>(bucket: string, load: () => Promise<T[]>): Promise<T[]>;
+    cacheGet<T>(bucket: string, id: number | string, load?: () => Promise<T[]>): Promise<T | undefined>;
+    /**
+     * 写入缓存。数组整桶替换；单条对象按 id 合并更新。
+     */
+    cacheSet(bucket: string, data: unknown): Promise<void>;
+    /** 删除整桶，或按 id 删除 */
+    cacheDel(bucket: string, id?: number | string | Array<number | string>): Promise<void>;
 }

package/dist/orm/tenant.d.ts

@@ -14,7 +14,20 @@ export declare function tableHasTenantId(table: PgTable): boolean;
 export declare function resolveTenantScope(): 'off' | 'all' | 'none' | number;
 /** 拼租户 where；无隔离时返回原 where */
 export declare function applyTenantWhere(table: PgTable, where?: SQL): SQL | undefined;
-/** 写入时自动带上 tenantId（仅普通租户用户） */
+type TenantHostResolver = (host: string) => Promise<number | undefined>;
+/** 宿主注册：按请求 Host 解析租户 id（仅 vome.tenant 开启时调用） */
+export declare function registerTenantHostResolver(fn: TenantHostResolver | null): void;
+/**
+ * 请求进入业务前绑定租户。
+ * 鉴权已从 token 写入 tenantId 时直接用，不再查库。
+ * 未登录请求走宿主注册的域名缓存。
+ */
+export declare function bindRequestTenant(): Promise<void>;
+/**
+ * 写入前处理 tenantId。
+ * - 关闭：丢掉客户端传入值，不写该列
+ * - 开启：忽略客户端传入值，仅在有租户上下文时填充
+ */
 export declare function stampTenantId<T extends Record<string, unknown>>(table: PgTable, data: T): T;
 /**
  * 局部关闭租户过滤（跨租户查询、登录、权限菜单等）
@@ -22,3 +35,4 @@ export declare function stampTenantId<T extends Record<string, unknown>>(table:
 export declare function noTenant<T>(fn: () => Promise<T>): Promise<T>;
 /** 规范化 Host：小写、去端口 */
 export declare function normalizeHost(host: string | null | undefined): string;
+export {};

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, 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, q, attachCrudRoutes, isTenantEnabled, noTenant, normalizeHost, resolveTenantScope, tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, noDataScope, 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, 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, registerEntityCacheStore, q, attachCrudRoutes, isTenantEnabled, noTenant, normalizeHost, resolveTenantScope, registerTenantHostResolver, bindRequestTenant, tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, noDataScope, 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';