vome-core 0.3.68 → 0.3.70

package/typings/comm/scan.ts

@@ -1,6 +1,6 @@
-export type ScanOptions = {
-  /** 宿主项目根目录，默认 process.cwd() */
-  cwd?: string
-  /** 扩展名过滤，默认 .ts / .tsx */
-  ext?: RegExp
-}
+export type ScanOptions = {
+  /** 宿主项目根目录，默认 process.cwd() */
+  cwd?: string
+  /** 扩展名过滤，默认 .ts / .tsx */
+  ext?: RegExp
+}

package/typings/common.ts

@@ -1,4 +1,4 @@
-/**
- * 宽松对象类型：在固定字段基础上允许追加任意属性
- */
-export type Loose<T extends object> = T & { [key: string]: any }
+/**
+ * 宽松对象类型：在固定字段基础上允许追加任意属性
+ */
+export type Loose<T extends object> = T & { [key: string]: any }

package/typings/context/data.ts

@@ -1,10 +1,10 @@
-/** ALS 存储的请求上下文数据 */
-export interface ContextData {
-  requestId: string
-  method: string
-  path: string
-  /** 客户端 IP（优先代理头，无则空串） */
-  ip: string
-  startTime: number
-  [key: string]: unknown
-}
+/** ALS 存储的请求上下文数据 */
+export interface ContextData {
+  requestId: string
+  method: string
+  path: string
+  /** 客户端 IP（优先代理头，无则空串） */
+  ip: string
+  startTime: number
+  [key: string]: unknown
+}

package/typings/ext/market-seat.ts

@@ -1,42 +1,42 @@
-/** 席位占用结果（市场签发 ticket 后由 core 解析） */
-export type MarketSeatStatus = {
-  marketId: string
-  /** unlimited：作者/免费；ok：已占席；blocked：超席；pending：待联网登记 */
-  state: 'unlimited' | 'ok' | 'blocked' | 'pending' | 'unknown'
-  /** 展示用：作者/免费为 null → UI 显示 / */
-  seats: number | null
-  used: number | null
-  reason?: string
-  updateTime: string
-}
-
-export type MarketSeatTicketPayload = {
-  v: 1
-  kind: 'seat'
-  marketId: string
-  siteId: string
-  unlimited: boolean
-  allowed: boolean
-  seats: number | null
-  used: number | null
-  issuedAt: string
-  expireAt: string
-  reason?: string | null
-}
-
-export type MarketSeatTicket = {
-  payload: MarketSeatTicketPayload
-  sig: string
-}
-
-/** core 内置席位调度默认（宿主可用 VomeConfig.market 覆盖） */
-export const MARKET_SEAT_DEFAULTS = {
-  /** 付费购买默认席位数 */
-  baseSeats: 3,
-  /** 运行中心跳间隔 */
-  heartbeatIntervalMs: 12 * 60 * 60 * 1000,
-  /** 无心跳自动释放占用（天） */
-  staleDays: 30,
-  /** 签发 ticket 有效期（短） */
-  ticketTtlMs: 15 * 60 * 1000,
-} as const
+/** 席位占用结果（市场签发 ticket 后由 core 解析） */
+export type MarketSeatStatus = {
+  marketId: string
+  /** unlimited：作者/免费；ok：已占席；blocked：超席；pending：待联网登记 */
+  state: 'unlimited' | 'ok' | 'blocked' | 'pending' | 'unknown'
+  /** 展示用：作者/免费为 null → UI 显示 / */
+  seats: number | null
+  used: number | null
+  reason?: string
+  updateTime: string
+}
+
+export type MarketSeatTicketPayload = {
+  v: 1
+  kind: 'seat'
+  marketId: string
+  siteId: string
+  unlimited: boolean
+  allowed: boolean
+  seats: number | null
+  used: number | null
+  issuedAt: string
+  expireAt: string
+  reason?: string | null
+}
+
+export type MarketSeatTicket = {
+  payload: MarketSeatTicketPayload
+  sig: string
+}
+
+/** core 内置席位调度默认（宿主可用 VomeConfig.market 覆盖） */
+export const MARKET_SEAT_DEFAULTS = {
+  /** 付费购买默认席位数 */
+  baseSeats: 3,
+  /** 运行中心跳间隔 */
+  heartbeatIntervalMs: 12 * 60 * 60 * 1000,
+  /** 无心跳自动释放占用（天） */
+  staleDays: 30,
+  /** 签发 ticket 有效期（短） */
+  ticketTtlMs: 15 * 60 * 1000,
+} as const

package/typings/ext/market.ts

@@ -1,55 +1,55 @@
-/** 市场签发包定价 */
-export type MarketPricing = 'free' | 'paid'
-
-/** market.sig 签名载荷（稳定字段，勿随意增删） */
-export type MarketSigPayload = {
-  marketId: string
-  pricing: MarketPricing
-  version: string
-  key: string
-  contentHash: string
-}
-
-/** 离线 / 联网 license 载荷 */
-export type MarketLicensePayload = {
-  v: 1
-  marketId: string
-  buyerId: string
-  issuedAt: string
-  /** null = 永久 */
-  expireAt: string | null
-  orderNo?: string | null
-  /** 联网签发时必填，须与请求 nonce 一致 */
-  nonce?: string | null
-  pluginName?: string | null
-}
-
-/** 磁盘 / 接口中的 license 文件结构 */
-export type MarketLicenseFile = {
-  payload: MarketLicensePayload
-  sig: string
-}
-
-export type InstallGateKind =
-  | 'local'
-  | 'market-free'
-  | 'market-paid'
-
-export type InstallGateResult = {
-  kind: InstallGateKind
-  marketId?: string
-  via?: 'file' | 'network'
-}
-
-export type AssertModuleInstallOptions = {
-  /** 覆盖 core 内置市场公钥（SPKI DER base64 或 PEM） */
-  marketPublicKey?: string | Uint8Array
-  /**
-   * 联网拉取「签名 license 原文」；core 只验签，不采信 boolean。
-   * 返回 null/空 = 无凭证。
-   */
-  fetchSignedLicense?: (
-    marketId: string,
-    nonce: string,
-  ) => Promise<string | MarketLicenseFile | null | undefined>
-}
+/** 市场签发包定价 */
+export type MarketPricing = 'free' | 'paid'
+
+/** market.sig 签名载荷（稳定字段，勿随意增删） */
+export type MarketSigPayload = {
+  marketId: string
+  pricing: MarketPricing
+  version: string
+  key: string
+  contentHash: string
+}
+
+/** 离线 / 联网 license 载荷 */
+export type MarketLicensePayload = {
+  v: 1
+  marketId: string
+  buyerId: string
+  issuedAt: string
+  /** null = 永久 */
+  expireAt: string | null
+  orderNo?: string | null
+  /** 联网签发时必填，须与请求 nonce 一致 */
+  nonce?: string | null
+  pluginName?: string | null
+}
+
+/** 磁盘 / 接口中的 license 文件结构 */
+export type MarketLicenseFile = {
+  payload: MarketLicensePayload
+  sig: string
+}
+
+export type InstallGateKind =
+  | 'local'
+  | 'market-free'
+  | 'market-paid'
+
+export type InstallGateResult = {
+  kind: InstallGateKind
+  marketId?: string
+  via?: 'file' | 'network'
+}
+
+export type AssertModuleInstallOptions = {
+  /** 覆盖 core 内置市场公钥（SPKI DER base64 或 PEM） */
+  marketPublicKey?: string | Uint8Array
+  /**
+   * 联网拉取「签名 license 原文」；core 只验签，不采信 boolean。
+   * 返回 null/空 = 无凭证。
+   */
+  fetchSignedLicense?: (
+    marketId: string,
+    nonce: string,
+  ) => Promise<string | MarketLicenseFile | null | undefined>
+}

package/typings/ext/module.ts

@@ -1,64 +1,64 @@
-export type ModuleRouteDef = {
-  method: string
-  path: string
-  handler: string
-  perms?: string
-  summary?: string
-}
-
-export type ModuleMenuDef = {
-  name: string
-  router?: string
-  perms?: string
-  type?: number
-  icon?: string
-  orderNum?: number
-  appKey?: string
-  isShow?: boolean
-}
-
-export type ModuleManifest = {
-  name: string
-  key: string
-  version: string
-  description?: string
-  hook?: string
-  config?: Record<string, unknown>
-  singleton?: boolean
-  author?: string
-  logo?: string
-  readme?: string
-  routes?: ModuleRouteDef[]
-  menus?: ModuleMenuDef[]
-  /**
-   * 插件市场终身 ID（仅市场注入，作者勿手写）
-   * 无 market.sig 时忽略，按自研包安装
-   */
-  marketId?: string
-  /** 市场定价；与 market.sig 一致 */
-  pricing?: 'free' | 'paid'
-}
-
-export type ModuleHandlerCtx = {
-  body: unknown
-  query: Record<string, string>
-  params: Record<string, string>
-  headers: Headers
-  adminId?: number | string
-}
-
-export type ModuleHandler = (ctx: ModuleHandlerCtx) => unknown | Promise<unknown>
-
-export type ModuleInstalled = ModuleManifest & {
-  path: string
-  hasServer: boolean
-  hasWeb: boolean
-  hasHook: boolean
-  /** 席位展示（core 注入）；作者/免费 seatsLabel/usedLabel 为 / */
-  seat?: {
-    seatsLabel: string
-    usedLabel: string
-    blocked: boolean
-    tip?: string
-  }
-}
+export type ModuleRouteDef = {
+  method: string
+  path: string
+  handler: string
+  perms?: string
+  summary?: string
+}
+
+export type ModuleMenuDef = {
+  name: string
+  router?: string
+  perms?: string
+  type?: number
+  icon?: string
+  orderNum?: number
+  appKey?: string
+  isShow?: boolean
+}
+
+export type ModuleManifest = {
+  name: string
+  key: string
+  version: string
+  description?: string
+  hook?: string
+  config?: Record<string, unknown>
+  singleton?: boolean
+  author?: string
+  logo?: string
+  readme?: string
+  routes?: ModuleRouteDef[]
+  menus?: ModuleMenuDef[]
+  /**
+   * 插件市场终身 ID（仅市场注入，作者勿手写）
+   * 无 market.sig 时忽略，按自研包安装
+   */
+  marketId?: string
+  /** 市场定价；与 market.sig 一致 */
+  pricing?: 'free' | 'paid'
+}
+
+export type ModuleHandlerCtx = {
+  body: unknown
+  query: Record<string, string>
+  params: Record<string, string>
+  headers: Headers
+  adminId?: number | string
+}
+
+export type ModuleHandler = (ctx: ModuleHandlerCtx) => unknown | Promise<unknown>
+
+export type ModuleInstalled = ModuleManifest & {
+  path: string
+  hasServer: boolean
+  hasWeb: boolean
+  hasHook: boolean
+  /** 席位展示（core 注入）；作者/免费 seatsLabel/usedLabel 为 / */
+  seat?: {
+    seatsLabel: string
+    usedLabel: string
+    blocked: boolean
+    tip?: string
+  }
+}

package/typings/ext/plugin.ts

@@ -1,38 +1,38 @@
-export type PluginManifest = {
-  name: string
-  key: string
-  hook?: string
-  singleton?: boolean
-  version: string
-  description?: string
-  author?: string
-  logo?: string
-  readme?: string
-  config?: Record<string, unknown>
-}
-
-export type PluginInfo = PluginManifest & {
-  config?: Record<string, unknown>
-}
-
-export type PluginPayload = {
-  content: { type: 'comm' | 'module'; data: string }
-  tsContent: { type: 'ts'; data: string }
-}
-
-export type PluginCheckResult = {
-  type: 0 | 1 | 2 | 3
-  message: string
-}
-
-export type PluginServices = {
-  cache?: {
-    get: (key: string) => Promise<unknown>
-    set: (key: string, value: unknown) => Promise<unknown>
-    del: (key: string) => Promise<unknown>
-  }
-  pluginService?: {
-    getInstance: (key: string) => Promise<unknown>
-    invoke: (key: string, method: string, ...params: unknown[]) => Promise<unknown>
-  }
-}
+export type PluginManifest = {
+  name: string
+  key: string
+  hook?: string
+  singleton?: boolean
+  version: string
+  description?: string
+  author?: string
+  logo?: string
+  readme?: string
+  config?: Record<string, unknown>
+}
+
+export type PluginInfo = PluginManifest & {
+  config?: Record<string, unknown>
+}
+
+export type PluginPayload = {
+  content: { type: 'comm' | 'module'; data: string }
+  tsContent: { type: 'ts'; data: string }
+}
+
+export type PluginCheckResult = {
+  type: 0 | 1 | 2 | 3
+  message: string
+}
+
+export type PluginServices = {
+  cache?: {
+    get: (key: string) => Promise<unknown>
+    set: (key: string, value: unknown) => Promise<unknown>
+    del: (key: string) => Promise<unknown>
+  }
+  pluginService?: {
+    getInstance: (key: string) => Promise<unknown>
+    invoke: (key: string, method: string, ...params: unknown[]) => Promise<unknown>
+  }
+}

package/typings/ioc/metadata.ts

@@ -1,34 +1,34 @@
-/** IoC 作用域 */
-export type ScopeValue = 'singleton' | 'request' | 'prototype'
-
-/** 可 new 的 Provider 类 */
-export type ClassToken<T = unknown> = abstract new (...args: any[]) => T
-
-/**
- * 注入标识：类 / 字符串 id / symbol
- * 字符串 id 用于跨模块按名注入
- */
-export type InjectionToken<T = unknown> = ClassToken<T> | string | symbol
-
-export type InjectMeta = {
-  propertyKey: string | symbol
-  /** 依赖标识；与 resolve 二选一 */
-  token?: InjectionToken
-  /** 自定义解析（如 Repository） */
-  resolve?: () => unknown
-}
-
-export type ProviderMeta = {
-  /** 注册键（类或自定义 id） */
-  token: InjectionToken
-  /** 实际用来 new 的类 */
-  useClass: ClassToken
-  scope: ScopeValue
-}
-
-export type ProvideOptions = {
-  /** 自定义标识，可用 `@Inject('id')` / `Ioc.get('id')` */
-  id?: string | symbol
-  /** 作用域，默认 singleton */
-  scope?: ScopeValue
-}
+/** IoC 作用域 */
+export type ScopeValue = 'singleton' | 'request' | 'prototype'
+
+/** 可 new 的 Provider 类 */
+export type ClassToken<T = unknown> = abstract new (...args: any[]) => T
+
+/**
+ * 注入标识：类 / 字符串 id / symbol
+ * 字符串 id 用于跨模块按名注入
+ */
+export type InjectionToken<T = unknown> = ClassToken<T> | string | symbol
+
+export type InjectMeta = {
+  propertyKey: string | symbol
+  /** 依赖标识；与 resolve 二选一 */
+  token?: InjectionToken
+  /** 自定义解析（如 Repository） */
+  resolve?: () => unknown
+}
+
+export type ProviderMeta = {
+  /** 注册键（类或自定义 id） */
+  token: InjectionToken
+  /** 实际用来 new 的类 */
+  useClass: ClassToken
+  scope: ScopeValue
+}
+
+export type ProvideOptions = {
+  /** 自定义标识，可用 `@Inject('id')` / `Ioc.get('id')` */
+  id?: string | symbol
+  /** 作用域，默认 singleton */
+  scope?: ScopeValue
+}

package/typings/logger/config.ts

@@ -1,6 +1,6 @@
-export type LoggingConfig = {
-  level?: string
-  transport?: 'console' | 'file'
-  dir?: string
-  maxDays?: number
-}
+export type LoggingConfig = {
+  level?: string
+  transport?: 'console' | 'file'
+  dir?: string
+  maxDays?: number
+}