@tbox.cn/app-contracts-mall 0.1.1 → 0.9.0

package/dist/query-context.d.ts

@@ -0,0 +1,47 @@
+/**
+ * mall 查询上下文组装单源（读/写/消费三层中的消费层 + query 写入口）。
+ *
+ * 原子 + 组合子分层：mallScopeOrEmpty / mallSubjectIdOf 为原子，toMallQueryContext 为
+ * 宽松组合子；strict 语义（member 域 throw / shopping-guide toShoppingQueryContext）
+ * 留在模块内，不在本文件。
+ *
+ * plazaId 边界（不可变约束）：plazaId 归一是客户端 mall-scope-url 单点职责，
+ * 本文件只认 mallId 契约键，不接受别名（四道防护见 docs/plans/mall-scope-unification）。
+ */
+import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { MallScope } from './scope';
+/** C 端查询上下文公共形状（三域 *QueryContext extends；未来新域直接继承） */
+export interface MallQueryContext {
+    readonly scope: MallScope;
+    readonly subjectId?: string;
+    readonly requestContext: RequestContext;
+}
+/**
+ * 空 mall scope 兜底（demo/单实例部署：scope 缺席时以空 mallId 命中 mock 单实例）。
+ * 函数化而非共享常量——miss 返回新对象，免疫「调用方原地改写」共享引用事故。
+ */
+export declare function mallScopeOrEmpty(reqCtx: RequestContext): MallScope;
+/**
+ * C 端主体归一（登录态 = source !== 'anonymous'，与 mall-context.ts 定义同源）。
+ * 五模块 subjectId 判式三态分裂（!=='anonymous' / 无条件 / local‖external）的归一点。
+ */
+export declare function mallSubjectIdOf(reqCtx: RequestContext): string | undefined;
+/**
+ * GET 路由 mall scope 供给：query 部分形状 → attributes 注入（唯一写入口）。
+ *
+ * - mallId 非空 string（trim）才注入，覆盖既有 attributes.mall（与既有 spread 覆盖语义一致）；
+ * - miniAppId = query 透传优先 → opts.miniAppId 兜底（模块路由 = 卡片 data 链回传；
+ *   模板路由 = 配置面 root config/malls 表——两种真实并存的真源策略）；双缺 → 注入
+ *   mallId-only（v4：miniAppId 可选——URL 明确携带 mallId 却落全局会话是与恒动态
+ *   语义矛盾的倒退；parseMallScope 对 mallId-only 恒成功，旧「注入了却 parse 不了」
+ *   中间态不复存在）；
+ * - 只认 mallId 契约键；plazaId 归一是客户端 mall-scope-url 单点职责，本入口不接受别名；
+ * - 安全模型同登录面：无入口白名单，registry per-service scope 绑定兜底
+ *   （伪造 mallId → resolveService 预期缺席 → 各域兜底/fail-loud）；
+ * - query 结构型参数 Readonly<Record<string, unknown>> 不耦合 express（ParsedQs 结构兼容）。
+ */
+export declare function withMallScopeFromQuery(reqCtx: RequestContext, query: Readonly<Record<string, unknown>>, opts?: {
+    miniAppId?: string;
+}): RequestContext;
+/** 宽松组合子：空兜底 + 主体归一一键组装（零参数——无覆盖口） */
+export declare function toMallQueryContext(reqCtx: RequestContext): MallQueryContext;

package/dist/runtime.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @tbox.cn/app-contracts-mall runtime 入口（011 A5：types-only → types + runtime）。
+ * 本文件为唯一运行时 JS（经 tsup/esbuild 出 dist/runtime.js）；
+ * 类型面仍经 tsc emitDeclarationOnly 出 dist/*.d.ts。
+ * 依赖方向：contracts-mall → contracts（TIER0）；SDK 不 import 本包（011 B3）。
+ */
+export { MALL_SCOPE_KEY, mallScopeSchema, mallSlot, parseMallScope, extractMallScope, mallScopeOf, readLoginMallId } from './scope';
+export { mallScopeOrEmpty, mallSubjectIdOf, withMallScopeFromQuery, toMallQueryContext } from './query-context';
+export { createMallRuntimeAssembly, createMallContextValidator, AUTH_LOGIN_SERVICE } from './assembly';
+export { MEMBER_ACCOUNT_SERVICE, MEMBER_PROFILE_SERVICE, MEMBER_CARD_SERVICE, MEMBER_BENEFITS_SERVICE, MEMBER_ENROLLMENT_SERVICE, classifyMemberOutcome, externalMemberRefOf, memberGateCardOf, resolveMemberGate, } from './services/member';
+export { PARKING_QUERY_SERVICE, PARKING_PAYMENT_SERVICE, PARKING_VEHICLE_SERVICE } from './services/parking';
+export { PROMOTION_OFFERS_SERVICE, PROMOTION_ENTITLEMENTS_SERVICE, PROMOTION_ACTIVITIES_SERVICE, PROMOTION_ACQUISITION_SERVICE, PROMOTION_ACTIVITY_ROUTING_POLICY, } from './services/promotion';
+export { SHOPPING_CATALOG_SERVICE, SHOPPING_SHOPS_SERVICE, SHOPPING_CATEGORIES_SERVICE, SHOPPING_DIRECTORY_SERVICE, } from './services/shopping-guide';
+export { MALL_INFO_SERVICE } from './services/mall-info';
+export { mallLocationSchema, parseMallLocation, mallUserRefSchema, parseMallUserRef } from './guard';
+export * from './shopping-guide/cards';
+export * from './member/cards';
+export * from './promotion/cards';
+export * from './parking/cards';
+export * from './shared/cards';