@open-mercato/core 0.8.1-develop.7296.1.2111d779db → 0.8.1-develop.7441.1.b42958b98c

package/dist/modules/customer_groups/services/customerGroupsService.js

@@ -0,0 +1,190 @@
+import { unionScopes } from "@open-mercato/shared/lib/catalog-visibility";
+import { CustomerGroup, CustomerGroupMembership, CustomerGroupTerms } from "../data/entities.js";
+import { CUSTOMER_GROUP_MAX_ANCESTOR_DEPTH } from "../data/validators.js";
+const TERMS_FIELD_NAMES = [
+  "priceKindId",
+  "paymentTermsDays",
+  "allowPurchaseOnAccount",
+  "approvalRequiredAbove",
+  "minOrderValue"
+];
+const MAX_ANCESTOR_DEPTH = CUSTOMER_GROUP_MAX_ANCESTOR_DEPTH;
+function groupOwnAssortmentScope(_groupId) {
+  return null;
+}
+async function loadGroupCached(em, groupId, tenantId, cache) {
+  if (cache.has(groupId)) return cache.get(groupId) ?? null;
+  const group = await em.findOne(CustomerGroup, { id: groupId, tenantId, deletedAt: null });
+  cache.set(groupId, group);
+  return group;
+}
+async function loadCustomerGroupAncestorChain(em, groupId, tenantId, cache = /* @__PURE__ */ new Map()) {
+  const chain = [];
+  let currentId = groupId;
+  while (currentId && chain.length < MAX_ANCESTOR_DEPTH) {
+    const group = await loadGroupCached(em, currentId, tenantId, cache);
+    if (!group || !group.isActive) break;
+    chain.push(group);
+    currentId = group.parentId ?? null;
+  }
+  return chain;
+}
+function toGroupSummary(group) {
+  return { id: group.id, code: group.code, name: group.name, kind: group.kind, priority: group.priority };
+}
+function isMembershipValidAt(membership, at) {
+  if (membership.validFrom && membership.validFrom.getTime() > at.getTime()) return false;
+  if (membership.validUntil && membership.validUntil.getTime() < at.getTime()) return false;
+  return true;
+}
+function tenantDefaultTerms() {
+  return {
+    priceKindId: null,
+    paymentTermsDays: null,
+    allowPurchaseOnAccount: false,
+    approvalRequiredAbove: null,
+    minOrderValue: null,
+    sources: {
+      priceKindId: null,
+      paymentTermsDays: null,
+      allowPurchaseOnAccount: null,
+      approvalRequiredAbove: null,
+      minOrderValue: null
+    }
+  };
+}
+function toNumberOrNull(value) {
+  if (value == null) return null;
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+function termsFieldIsSet(terms, field) {
+  switch (field) {
+    case "priceKindId":
+      return terms.priceKindId != null;
+    case "paymentTermsDays":
+      return terms.paymentTermsDays != null;
+    case "allowPurchaseOnAccount":
+      return terms.allowPurchaseOnAccount != null;
+    case "approvalRequiredAbove":
+      return terms.approvalRequiredAbove != null;
+    case "minOrderValue":
+      return terms.minOrderValue != null;
+  }
+}
+function applyTermsField(result, field, terms, sourceGroupId) {
+  switch (field) {
+    case "priceKindId":
+      result.priceKindId = terms.priceKindId ?? null;
+      break;
+    case "paymentTermsDays":
+      result.paymentTermsDays = terms.paymentTermsDays ?? null;
+      break;
+    case "allowPurchaseOnAccount":
+      result.allowPurchaseOnAccount = terms.allowPurchaseOnAccount === true;
+      break;
+    case "approvalRequiredAbove":
+      result.approvalRequiredAbove = toNumberOrNull(terms.approvalRequiredAbove);
+      break;
+    case "minOrderValue":
+      result.minOrderValue = toNumberOrNull(terms.minOrderValue);
+      break;
+  }
+  result.sources[field] = sourceGroupId;
+}
+class DefaultCustomerGroupsService {
+  constructor(em) {
+    this.em = em;
+  }
+  async resolveGroups(input) {
+    const at = input.at ?? /* @__PURE__ */ new Date();
+    if (input.customerId == null) return this.resolveDefaultGroup(input.tenantId);
+    const memberships = await this.em.find(CustomerGroupMembership, {
+      tenantId: input.tenantId,
+      customerId: input.customerId,
+      deletedAt: null
+    });
+    const validMemberships = memberships.filter((membership) => isMembershipValidAt(membership, at));
+    if (!validMemberships.length) return this.resolveDefaultGroup(input.tenantId);
+    const latestMembershipByGroupId = /* @__PURE__ */ new Map();
+    for (const membership of validMemberships) {
+      const existing = latestMembershipByGroupId.get(membership.groupId);
+      if (!existing || membership.createdAt.getTime() > existing.createdAt.getTime()) {
+        latestMembershipByGroupId.set(membership.groupId, membership);
+      }
+    }
+    const groupIds = Array.from(latestMembershipByGroupId.keys());
+    const groups = await this.em.find(CustomerGroup, {
+      id: { $in: groupIds },
+      tenantId: input.tenantId,
+      isActive: true,
+      deletedAt: null
+    });
+    const sortedGroups = groups.slice().sort((a, b) => {
+      if (b.priority !== a.priority) return b.priority - a.priority;
+      const membershipA = latestMembershipByGroupId.get(a.id);
+      const membershipB = latestMembershipByGroupId.get(b.id);
+      return membershipB.createdAt.getTime() - membershipA.createdAt.getTime();
+    });
+    if (!sortedGroups.length) return this.resolveDefaultGroup(input.tenantId);
+    return {
+      groupIds: sortedGroups.map((group) => group.id),
+      groups: sortedGroups.map(toGroupSummary)
+    };
+  }
+  async resolveDefaultGroup(tenantId) {
+    const defaultGroup = await this.em.findOne(CustomerGroup, {
+      tenantId,
+      isDefault: true,
+      isActive: true,
+      deletedAt: null
+    });
+    if (!defaultGroup) return { groupIds: [], groups: [] };
+    return { groupIds: [defaultGroup.id], groups: [toGroupSummary(defaultGroup)] };
+  }
+  async resolveTerms(input) {
+    const groupIds = input.groupIds ?? (await this.resolveGroups({ customerId: input.customerId, tenantId: input.tenantId, at: input.at })).groupIds;
+    if (!groupIds.length) return tenantDefaultTerms();
+    const groupCache = /* @__PURE__ */ new Map();
+    const termsCache = /* @__PURE__ */ new Map();
+    const chains = [];
+    for (const groupId of groupIds) {
+      const chain = await loadCustomerGroupAncestorChain(this.em, groupId, input.tenantId, groupCache);
+      chains.push(chain.map((group) => group.id));
+    }
+    const result = tenantDefaultTerms();
+    for (const field of TERMS_FIELD_NAMES) {
+      chainLoop: for (const chain of chains) {
+        for (const ancestorId of chain) {
+          const terms = await this.loadTerms(ancestorId, input.tenantId, termsCache);
+          if (!terms) continue;
+          if (!termsFieldIsSet(terms, field)) continue;
+          applyTermsField(result, field, terms, ancestorId);
+          break chainLoop;
+        }
+      }
+    }
+    return result;
+  }
+  async resolveAssortmentScope(input) {
+    const { groupIds } = await this.resolveGroups(input);
+    const scope = unionScopes(groupIds.map((groupId) => groupOwnAssortmentScope(groupId)));
+    return { scope, sourceGroupIds: groupIds, sourceCustomerOverrideId: null };
+  }
+  async loadTerms(groupId, tenantId, cache) {
+    if (cache.has(groupId)) return cache.get(groupId) ?? null;
+    const terms = await this.em.findOne(CustomerGroupTerms, { groupId, tenantId, deletedAt: null });
+    cache.set(groupId, terms);
+    return terms;
+  }
+}
+function createCustomerGroupsService(em) {
+  return new DefaultCustomerGroupsService(em);
+}
+export {
+  DefaultCustomerGroupsService,
+  createCustomerGroupsService,
+  isMembershipValidAt,
+  loadCustomerGroupAncestorChain
+};
+//# sourceMappingURL=customerGroupsService.js.map

package/dist/modules/customer_groups/services/customerGroupsService.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/customer_groups/services/customerGroupsService.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { unionScopes } from '@open-mercato/shared/lib/catalog-visibility'\nimport type { AssortmentScope, EffectiveAssortmentScope } from '@open-mercato/shared/lib/catalog-visibility'\nimport { CustomerGroup, CustomerGroupMembership, CustomerGroupTerms } from '../data/entities'\nimport { CUSTOMER_GROUP_MAX_ANCESTOR_DEPTH } from '../data/validators'\n\nexport type GroupResolution = {\n  groupIds: string[]\n  groups: Array<{ id: string; code: string; name: string; kind: string; priority: number }>\n}\n\n// The five scalar fields `resolveTerms` resolves per group, independently of one\n// another (spec \u00A76.1). Kept as a `const` tuple (not a hardcoded literal union) so the\n// resolution loop and the `sources` map share a single source of truth for the field\n// list.\nconst TERMS_FIELD_NAMES = [\n  'priceKindId',\n  'paymentTermsDays',\n  'allowPurchaseOnAccount',\n  'approvalRequiredAbove',\n  'minOrderValue',\n] as const\ntype TermsFieldName = (typeof TERMS_FIELD_NAMES)[number]\n\n// Spec \u00A76.1's illustrative type sketch shows a single shared `sourceGroupId` on\n// `ResolvedTerms`, but its own acceptance criteria (US-C2: \"each resolved scalar\n// field... shows its value and the group it came from\") require independent\n// per-field provenance \u2014 a customer can get `paymentTermsDays` from a grandparent\n// while `priceKindId` comes straight from its own group. Modeled as a `sources` map\n// keyed by field name (rather than five parallel `<field>SourceGroupId` fields) so\n// the resolution loop can write `result.sources[field] = groupId` generically instead\n// of a per-field switch, and so a future terms field only needs adding to\n// `TERMS_FIELD_NAMES` instead of a new parallel field everywhere.\nexport type ResolvedTermsSources = Record<TermsFieldName, string | null>\n\nexport type ResolvedTerms = {\n  priceKindId: string | null\n  paymentTermsDays: number | null\n  allowPurchaseOnAccount: boolean\n  approvalRequiredAbove: number | null\n  minOrderValue: number | null\n  sources: ResolvedTermsSources\n}\n\n// Ancestor-walk depth cap \u2014 the group hierarchy's own depth cap (spec \u00A75.1, enforced at\n// create/update time by `findParentAssignmentIssue`), shared so the two cannot drift.\n// Defensive only: normal data can never produce a chain this long, but this stops a\n// corrupt/cyclic `parentId` graph from looping forever.\nconst MAX_ANCESTOR_DEPTH = CUSTOMER_GROUP_MAX_ANCESTOR_DEPTH\n\n// `customer_groups` entities are tenant-scoped only (see the \"Groups are\n// tenant-scoped, not organization-scoped\" note in `data/entities.ts`), and this\n// codebase has no ambient/DI-resolved tenant context \u2014 `createRequestContainer()`\n// (packages/shared/src/lib/di/container.ts) builds the container before auth is\n// resolved, and every DB-querying DI service in this repo that needs tenant scope\n// takes it as an explicit caller-supplied argument (see\n// `warranty_claims/services/entitlementResolver.ts`'s `resolveEntitlement(input, scope, em)`).\n// The illustrative `resolveGroups(input: { customerId, at })` signature in\n// `.ai/specs/2026-08-14-customer-groups-and-b2b-terms.md` \u00A76 omits `tenantId` for\n// brevity; `tenantId` is added here to the input so this service can never silently\n// query across tenants (root AGENTS.md \u00A7 Never: \"expose cross-tenant data or skip\n// tenant/organization scoping\").\nexport type ResolveGroupsInput = {\n  customerId: string | null\n  tenantId: string\n  at?: Date\n}\n\n// `groupIds` is optional and, when supplied by a caller who already resolved the\n// customer's groups, skips the membership-resolution query inside `resolveTerms` \u2014\n// `resolveGroups`'s own DB round-trips (memberships + groups, or the tenant-default\n// lookup) are not repeated. Ancestor/terms rows are still fetched fresh regardless,\n// since `resolveGroups` never returns those.\nexport type ResolveTermsInput = {\n  customerId: string | null\n  tenantId: string\n  at?: Date\n  groupIds?: string[]\n}\n\n// Same shape as `ResolveGroupsInput` \u2014 `resolveAssortmentScope` delegates straight to\n// `resolveGroups()` and adds no extra inputs of its own. Aliased rather than reused\n// directly so a future assortment-specific input (e.g. a channel id, once Phase 2 of\n// catalog-visibility composes channel scope too) doesn't ripple through `resolveGroups`'s\n// own signature.\nexport type ResolveAssortmentScopeInput = ResolveGroupsInput\n\nexport type ResolvedAssortmentScope = {\n  scope: EffectiveAssortmentScope\n  sourceGroupIds: string[]\n  // Always `null` in Phase 1 \u2014 `CustomerAssortmentOverride` (per-customer override table)\n  // is Phase 4 scope (spec \u00A714 non-goals) and does not exist yet. Never read from anywhere;\n  // this is a fixed literal until that phase lands.\n  sourceCustomerOverrideId: string | null\n}\n\nexport interface CustomerGroupsService {\n  resolveGroups(input: ResolveGroupsInput): Promise<GroupResolution>\n  resolveTerms(input: ResolveTermsInput): Promise<ResolvedTerms>\n  resolveAssortmentScope(input: ResolveAssortmentScopeInput): Promise<ResolvedAssortmentScope>\n}\n\n// Phase 1's `CustomerGroup` entity has no `assortment_scope`-shaped column yet \u2014 the spec's\n// full field list places it on `CustomerGroupTerms`, but that was deliberately withheld from\n// this PR's Step 2.1 entity (Phase 5 scope, spec \u00A714 non-goals). Every matching group\n// therefore contributes an unrestricted (`null`) own-scope for now. Once a real column\n// exists, replace this stub's body with a read of it \u2014 `resolveAssortmentScope`'s\n// `unionScopes` composition below needs no changes to start returning real restrictions.\nfunction groupOwnAssortmentScope(_groupId: string): AssortmentScope | null {\n  return null\n}\n\nasync function loadGroupCached(\n  em: EntityManager,\n  groupId: string,\n  tenantId: string,\n  cache: Map<string, CustomerGroup | null>,\n): Promise<CustomerGroup | null> {\n  if (cache.has(groupId)) return cache.get(groupId) ?? null\n  const group = await em.findOne(CustomerGroup, { id: groupId, tenantId, deletedAt: null })\n  cache.set(groupId, group)\n  return group\n}\n\n/**\n * One group's ancestor chain \u2014 self first, then parent, grandparent, ... up to\n * `MAX_ANCESTOR_DEPTH` \u2014 as loaded, non-deleted, active, same-tenant entities. The\n * walk stops at the first id that does not resolve (soft-deleted, other tenant, or\n * dangling `parentId`) or resolves to an inactive group (spec \u00A75.1: inactive groups\n * are excluded from resolution): such a group is never part of the chain, so neither\n * its terms row nor anything above it can be inherited. Shared by `resolveTerms` and\n * the explain-terms route so the resolved value and the explained ancestor path always\n * come from the SAME chain. `cache` lets callers reuse group rows across several chains.\n */\nexport async function loadCustomerGroupAncestorChain(\n  em: EntityManager,\n  groupId: string,\n  tenantId: string,\n  cache: Map<string, CustomerGroup | null> = new Map(),\n): Promise<CustomerGroup[]> {\n  const chain: CustomerGroup[] = []\n  let currentId: string | null = groupId\n  while (currentId && chain.length < MAX_ANCESTOR_DEPTH) {\n    const group = await loadGroupCached(em, currentId, tenantId, cache)\n    if (!group || !group.isActive) break\n    chain.push(group)\n    currentId = group.parentId ?? null\n  }\n  return chain\n}\n\nfunction toGroupSummary(group: CustomerGroup): GroupResolution['groups'][number] {\n  return { id: group.id, code: group.code, name: group.name, kind: group.kind, priority: group.priority }\n}\n\nexport function isMembershipValidAt(\n  membership: Pick<CustomerGroupMembership, 'validFrom' | 'validUntil'>,\n  at: Date,\n): boolean {\n  if (membership.validFrom && membership.validFrom.getTime() > at.getTime()) return false\n  // Inclusive upper bound: a membership expiring exactly at `at` is still valid\n  // AT that instant (spec-derived rule \u2014 see the module's di.ts contract task).\n  if (membership.validUntil && membership.validUntil.getTime() < at.getTime()) return false\n  return true\n}\n\nfunction tenantDefaultTerms(): ResolvedTerms {\n  return {\n    priceKindId: null,\n    paymentTermsDays: null,\n    allowPurchaseOnAccount: false,\n    approvalRequiredAbove: null,\n    minOrderValue: null,\n    sources: {\n      priceKindId: null,\n      paymentTermsDays: null,\n      allowPurchaseOnAccount: null,\n      approvalRequiredAbove: null,\n      minOrderValue: null,\n    },\n  }\n}\n\nfunction toNumberOrNull(value: string | null | undefined): number | null {\n  if (value == null) return null\n  const parsed = Number(value)\n  return Number.isNaN(parsed) ? null : parsed\n}\n\n// Every terms field is a nullable column: `null` means \"not set on this group, keep\n// walking the ancestor chain\", so a group can override a single field and inherit the\n// rest.\nfunction termsFieldIsSet(terms: CustomerGroupTerms, field: TermsFieldName): boolean {\n  switch (field) {\n    case 'priceKindId':\n      return terms.priceKindId != null\n    case 'paymentTermsDays':\n      return terms.paymentTermsDays != null\n    case 'allowPurchaseOnAccount':\n      return terms.allowPurchaseOnAccount != null\n    case 'approvalRequiredAbove':\n      return terms.approvalRequiredAbove != null\n    case 'minOrderValue':\n      return terms.minOrderValue != null\n  }\n}\n\nfunction applyTermsField(\n  result: ResolvedTerms,\n  field: TermsFieldName,\n  terms: CustomerGroupTerms,\n  sourceGroupId: string,\n): void {\n  switch (field) {\n    case 'priceKindId':\n      result.priceKindId = terms.priceKindId ?? null\n      break\n    case 'paymentTermsDays':\n      result.paymentTermsDays = terms.paymentTermsDays ?? null\n      break\n    case 'allowPurchaseOnAccount':\n      result.allowPurchaseOnAccount = terms.allowPurchaseOnAccount === true\n      break\n    case 'approvalRequiredAbove':\n      result.approvalRequiredAbove = toNumberOrNull(terms.approvalRequiredAbove)\n      break\n    case 'minOrderValue':\n      result.minOrderValue = toNumberOrNull(terms.minOrderValue)\n      break\n  }\n  result.sources[field] = sourceGroupId\n}\n\nexport class DefaultCustomerGroupsService implements CustomerGroupsService {\n  constructor(private readonly em: EntityManager) {}\n\n  async resolveGroups(input: ResolveGroupsInput): Promise<GroupResolution> {\n    const at = input.at ?? new Date()\n\n    if (input.customerId == null) return this.resolveDefaultGroup(input.tenantId)\n\n    const memberships = await this.em.find(CustomerGroupMembership, {\n      tenantId: input.tenantId,\n      customerId: input.customerId,\n      deletedAt: null,\n    })\n\n    const validMemberships = memberships.filter((membership) => isMembershipValidAt(membership, at))\n    if (!validMemberships.length) return this.resolveDefaultGroup(input.tenantId)\n\n    // Precedence rule: when a customer has more than one membership row for the\n    // same group (e.g. re-added after a prior removal), the most recently created\n    // one is the one whose validity/attribution counts.\n    const latestMembershipByGroupId = new Map<string, CustomerGroupMembership>()\n    for (const membership of validMemberships) {\n      const existing = latestMembershipByGroupId.get(membership.groupId)\n      if (!existing || membership.createdAt.getTime() > existing.createdAt.getTime()) {\n        latestMembershipByGroupId.set(membership.groupId, membership)\n      }\n    }\n\n    const groupIds = Array.from(latestMembershipByGroupId.keys())\n    const groups = await this.em.find(CustomerGroup, {\n      id: { $in: groupIds },\n      tenantId: input.tenantId,\n      isActive: true,\n      deletedAt: null,\n    })\n\n    const sortedGroups = groups.slice().sort((a, b) => {\n      if (b.priority !== a.priority) return b.priority - a.priority\n      const membershipA = latestMembershipByGroupId.get(a.id)!\n      const membershipB = latestMembershipByGroupId.get(b.id)!\n      return membershipB.createdAt.getTime() - membershipA.createdAt.getTime()\n    })\n\n    if (!sortedGroups.length) return this.resolveDefaultGroup(input.tenantId)\n\n    return {\n      groupIds: sortedGroups.map((group) => group.id),\n      groups: sortedGroups.map(toGroupSummary),\n    }\n  }\n\n  private async resolveDefaultGroup(tenantId: string): Promise<GroupResolution> {\n    const defaultGroup = await this.em.findOne(CustomerGroup, {\n      tenantId,\n      isDefault: true,\n      isActive: true,\n      deletedAt: null,\n    })\n    if (!defaultGroup) return { groupIds: [], groups: [] }\n    return { groupIds: [defaultGroup.id], groups: [toGroupSummary(defaultGroup)] }\n  }\n\n  async resolveTerms(input: ResolveTermsInput): Promise<ResolvedTerms> {\n    const groupIds = input.groupIds\n      ?? (\n        await this.resolveGroups({ customerId: input.customerId, tenantId: input.tenantId, at: input.at })\n      ).groupIds\n\n    if (!groupIds.length) return tenantDefaultTerms()\n\n    // One ancestor chain per matching group, in the SAME priority order `groupIds`\n    // arrived in (self first, then parent, then grandparent, ... up to the depth\n    // cap). Computed once up front \u2014 the field loop below walks these same chains\n    // for every field, relying on `groupCache`/`termsCache` to avoid re-querying a\n    // group/terms row visited by an earlier chain or an earlier field.\n    const groupCache = new Map<string, CustomerGroup | null>()\n    const termsCache = new Map<string, CustomerGroupTerms | null>()\n    const chains: string[][] = []\n    for (const groupId of groupIds) {\n      const chain = await loadCustomerGroupAncestorChain(this.em, groupId, input.tenantId, groupCache)\n      chains.push(chain.map((group) => group.id))\n    }\n\n    const result = tenantDefaultTerms()\n\n    for (const field of TERMS_FIELD_NAMES) {\n      // \"highest-priority group with a non-null value \u2192 its ancestors\" is ONE\n      // resolution unit per priority-ordered group (spec \u00A76.1): walk THIS group's\n      // full ancestor chain to completion before moving to the next-priority group,\n      // not \"check every group's own row first, then every group's ancestors.\"\n      chainLoop: for (const chain of chains) {\n        for (const ancestorId of chain) {\n          const terms = await this.loadTerms(ancestorId, input.tenantId, termsCache)\n          if (!terms) continue\n          if (!termsFieldIsSet(terms, field)) continue\n          applyTermsField(result, field, terms, ancestorId)\n          break chainLoop\n        }\n      }\n    }\n\n    return result\n  }\n\n  async resolveAssortmentScope(input: ResolveAssortmentScopeInput): Promise<ResolvedAssortmentScope> {\n    const { groupIds } = await this.resolveGroups(input)\n    const scope = unionScopes(groupIds.map((groupId) => groupOwnAssortmentScope(groupId)))\n    return { scope, sourceGroupIds: groupIds, sourceCustomerOverrideId: null }\n  }\n\n  private async loadTerms(\n    groupId: string,\n    tenantId: string,\n    cache: Map<string, CustomerGroupTerms | null>,\n  ): Promise<CustomerGroupTerms | null> {\n    if (cache.has(groupId)) return cache.get(groupId) ?? null\n    const terms = await this.em.findOne(CustomerGroupTerms, { groupId, tenantId, deletedAt: null })\n    cache.set(groupId, terms)\n    return terms\n  }\n}\n\nexport function createCustomerGroupsService(em: EntityManager): CustomerGroupsService {\n  return new DefaultCustomerGroupsService(em)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/customer_groups/setup.js

@@ -0,0 +1,13 @@
+const setup = {
+  defaultRoleFeatures: {
+    superadmin: ["customer_groups.*"],
+    admin: ["customer_groups.*"],
+    employee: ["customer_groups.groups.view", "customer_groups.memberships.view", "customer_groups.terms.view"]
+  }
+};
+var setup_default = setup;
+export {
+  setup_default as default,
+  setup
+};
+//# sourceMappingURL=setup.js.map

package/dist/modules/customer_groups/setup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/customer_groups/setup.ts"],
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    superadmin: ['customer_groups.*'],\n    admin: ['customer_groups.*'],\n    employee: ['customer_groups.groups.view', 'customer_groups.memberships.view', 'customer_groups.terms.view'],\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,YAAY,CAAC,mBAAmB;AAAA,IAChC,OAAO,CAAC,mBAAmB;AAAA,IAC3B,UAAU,CAAC,+BAA+B,oCAAoC,4BAA4B;AAAA,EAC5G;AACF;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/dist/modules/customer_groups/widgets/injection/group-picker-field/widget.js

@@ -0,0 +1,31 @@
+import { lazy } from "react";
+const widget = {
+  metadata: {
+    id: "customer_groups.injection.group-picker-field",
+    priority: 100,
+    features: ["customer_groups.groups.view"]
+  },
+  fields: [
+    {
+      id: "customerGroupId",
+      label: "",
+      labelKey: "customer_groups.widgets.groupPicker.label",
+      type: "custom",
+      // Targets the `scope` group on `catalog.catalog_product_price` (see
+      // `catalog/components/prices/priceFormFields.tsx`, read-only reference —
+      // this file is never edited by this module). Field ids collide by
+      // design: `CrudForm` resolves a field by id via a `Map` built from
+      // `[...fields, ...injectedFieldWidgets]`, so the later (injected) entry
+      // wins and replaces the host's plain-text `customerGroupId` input; its
+      // value is still submitted with the host payload. `label` stays empty
+      // because `GroupPickerField` renders its own translated label.
+      group: "scope",
+      customComponent: lazy(() => import("../../../components/GroupPickerField.js"))
+    }
+  ]
+};
+var widget_default = widget;
+export {
+  widget_default as default
+};
+//# sourceMappingURL=widget.js.map

package/dist/modules/customer_groups/widgets/injection/group-picker-field/widget.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/customer_groups/widgets/injection/group-picker-field/widget.ts"],
+  "sourcesContent": ["import { lazy } from 'react'\nimport type { InjectionFieldWidget } from '@open-mercato/shared/modules/widgets/injection'\n\n// Step 1.11 \u2014 replaces the free-text `customerGroupId` UUID input on the\n// catalog price editor with a searchable picker sourced from\n// `/api/customer_groups/customer-groups`.\n//\n// This is a purely additive, optional injection: no `requires` entry is\n// declared anywhere, so `catalog` never gains a hard dependency on\n// `customer_groups`. When `customer_groups` is ejected/disabled, the widget\n// is never registered, `crud-form:<entityId>:fields` simply resolves empty,\n// and the host form falls back to its current plain free-text input with\n// no error \u2014 see `packages/core/src/modules/wms/widgets/injection/catalog-inventory-profile/widget.ts`\n// for the same pattern proven against `catalog.product`.\nconst widget: InjectionFieldWidget = {\n  metadata: {\n    id: 'customer_groups.injection.group-picker-field',\n    priority: 100,\n    features: ['customer_groups.groups.view'],\n  },\n  fields: [\n    {\n      id: 'customerGroupId',\n      label: '',\n      labelKey: 'customer_groups.widgets.groupPicker.label',\n      type: 'custom',\n      // Targets the `scope` group on `catalog.catalog_product_price` (see\n      // `catalog/components/prices/priceFormFields.tsx`, read-only reference \u2014\n      // this file is never edited by this module). Field ids collide by\n      // design: `CrudForm` resolves a field by id via a `Map` built from\n      // `[...fields, ...injectedFieldWidgets]`, so the later (injected) entry\n      // wins and replaces the host's plain-text `customerGroupId` input; its\n      // value is still submitted with the host payload. `label` stays empty\n      // because `GroupPickerField` renders its own translated label.\n      group: 'scope',\n      customComponent: lazy(() => import('../../../components/GroupPickerField')),\n    },\n  ],\n}\n\nexport default widget\n"],
+  "mappings": "AAAA,SAAS,YAAY;AAcrB,MAAM,SAA+B;AAAA,EACnC,UAAU;AAAA,IACR,IAAI;AAAA,IACJ,UAAU;AAAA,IACV,UAAU,CAAC,6BAA6B;AAAA,EAC1C;AAAA,EACA,QAAQ;AAAA,IACN;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,UAAU;AAAA,MACV,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MASN,OAAO;AAAA,MACP,iBAAiB,KAAK,MAAM,OAAO,sCAAsC,CAAC;AAAA,IAC5E;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/dist/modules/customer_groups/widgets/injection/person-groups-explain-terms.js

@@ -0,0 +1,166 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { apiCall, readApiResultOrThrow } from "@open-mercato/ui/backend/utils/apiCall";
+import { ErrorMessage, LoadingMessage } from "@open-mercato/ui/backend/detail";
+import { SectionHeader } from "@open-mercato/ui/backend/SectionHeader";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+const logger = createLogger("customer_groups").child({ component: "PersonGroupsExplainTerms" });
+const TERMS_FIELD_ORDER = [
+  "priceKindId",
+  "paymentTermsDays",
+  "allowPurchaseOnAccount",
+  "approvalRequiredAbove",
+  "minOrderValue"
+];
+const FIELD_LABEL_KEYS = {
+  priceKindId: ["customer_groups.groups.personTab.explainTerms.field.priceKindId", "Price kind"],
+  paymentTermsDays: ["customer_groups.groups.personTab.explainTerms.field.paymentTermsDays", "Payment terms"],
+  allowPurchaseOnAccount: [
+    "customer_groups.groups.personTab.explainTerms.field.allowPurchaseOnAccount",
+    "Allow purchase on account"
+  ],
+  approvalRequiredAbove: [
+    "customer_groups.groups.personTab.explainTerms.field.approvalRequiredAbove",
+    "Approval required above"
+  ],
+  minOrderValue: ["customer_groups.groups.personTab.explainTerms.field.minOrderValue", "Minimum order value"]
+};
+function pickString(item, ...keys) {
+  for (const key of keys) {
+    const value = item[key];
+    if (typeof value === "string" && value.length) return value;
+  }
+  return "";
+}
+async function resolvePriceKindLabel(id) {
+  try {
+    const params = new URLSearchParams({ ids: id, pageSize: "1" });
+    const payload = await readApiResultOrThrow(
+      `/api/catalog/price-kinds?${params.toString()}`,
+      void 0,
+      { fallback: { items: [] } }
+    );
+    const items = Array.isArray(payload.items) ? payload.items : [];
+    const item = items[0];
+    if (!item) return id;
+    const title = pickString(item, "title") || id;
+    const code = pickString(item, "code");
+    return code ? `${title} (${code})` : title;
+  } catch (err) {
+    logger.error("customer_groups.explainTerms.priceKind.resolve", { err });
+    return id;
+  }
+}
+function formatFieldValue(field, entry, priceKindLabels, t) {
+  const notSet = t("customer_groups.groups.personTab.explainTerms.notSet", "Not set");
+  if (field === "priceKindId") {
+    if (typeof entry.value !== "string" || !entry.value) return notSet;
+    return priceKindLabels[entry.value] ?? entry.value;
+  }
+  if (field === "paymentTermsDays") {
+    if (typeof entry.value !== "number") return notSet;
+    return t("customer_groups.groups.personTab.explainTerms.value.days", "{count} days", { count: entry.value });
+  }
+  if (field === "allowPurchaseOnAccount") {
+    if (typeof entry.value !== "boolean") return notSet;
+    return entry.value ? t("customer_groups.groups.personTab.explainTerms.value.yes", "Yes") : t("customer_groups.groups.personTab.explainTerms.value.no", "No");
+  }
+  if (typeof entry.value !== "number") return notSet;
+  return String(entry.value);
+}
+function formatSourceLabel(entry, t) {
+  if (entry.sourceGroupId == null) {
+    return t("customer_groups.groups.personTab.explainTerms.tenantDefault", "Tenant default");
+  }
+  const path = entry.path.map((group) => `${group.name} (${group.code})`).join(" \u2192 ");
+  return t("customer_groups.groups.personTab.explainTerms.viaPath", "via {path}", { path });
+}
+function ExplainTermsRow({
+  field,
+  entry,
+  priceKindLabels
+}) {
+  const t = useT();
+  const [labelKey, labelFallback] = FIELD_LABEL_KEYS[field];
+  const fieldLabel = t(labelKey, labelFallback);
+  const valueLabel = formatFieldValue(field, entry, priceKindLabels, t);
+  const sourceLabel = formatSourceLabel(entry, t);
+  return /* @__PURE__ */ jsxs("li", { className: "rounded-md border border-border bg-card px-3 py-2", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline justify-between gap-2", children: [
+      /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-foreground", children: fieldLabel }),
+      /* @__PURE__ */ jsx("span", { className: "text-sm text-foreground", children: valueLabel })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: sourceLabel })
+  ] });
+}
+function PersonGroupsExplainTerms({
+  customerId,
+  refreshKey = 0
+}) {
+  const t = useT();
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const [data, setData] = React.useState(null);
+  const [priceKindLabels, setPriceKindLabels] = React.useState({});
+  React.useEffect(() => {
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    apiCall(`/api/customer_groups/customer-groups/explain-terms?customerId=${encodeURIComponent(customerId)}`).then((res) => {
+      if (cancelled) return;
+      if (res.ok && res.result) {
+        setData(res.result);
+      } else if (res.status === 403) {
+        setData(null);
+      } else {
+        throw new Error("[internal] explain-terms");
+      }
+    }).catch(() => {
+      if (!cancelled) {
+        setError(
+          t("customer_groups.groups.personTab.explainTerms.errors.load", "Failed to load resolved terms.")
+        );
+      }
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [customerId, refreshKey, t]);
+  const priceKindId = data?.fields.priceKindId.value;
+  React.useEffect(() => {
+    let cancelled = false;
+    if (typeof priceKindId !== "string" || !priceKindId) return;
+    resolvePriceKindLabel(priceKindId).then((label) => {
+      if (!cancelled) setPriceKindLabels((prev) => prev[priceKindId] ? prev : { ...prev, [priceKindId]: label });
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [priceKindId]);
+  if (loading) {
+    return /* @__PURE__ */ jsx(LoadingMessage, { label: t("customer_groups.groups.personTab.explainTerms.loading", "Loading resolved terms\u2026") });
+  }
+  if (error) return /* @__PURE__ */ jsx(ErrorMessage, { label: error });
+  if (!data) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3 border-t border-border pt-3", children: [
+    /* @__PURE__ */ jsx(SectionHeader, { title: t("customer_groups.groups.personTab.explainTerms.title", "Explain terms") }),
+    /* @__PURE__ */ jsx(
+      "ul",
+      {
+        className: "space-y-2",
+        "aria-label": t("customer_groups.groups.personTab.explainTerms.listLabel", "Resolved commercial terms"),
+        children: TERMS_FIELD_ORDER.map((field) => /* @__PURE__ */ jsx(ExplainTermsRow, { field, entry: data.fields[field], priceKindLabels }, field))
+      }
+    )
+  ] });
+}
+var person_groups_explain_terms_default = PersonGroupsExplainTerms;
+export {
+  PersonGroupsExplainTerms,
+  person_groups_explain_terms_default as default
+};
+//# sourceMappingURL=person-groups-explain-terms.js.map

package/dist/modules/customer_groups/widgets/injection/person-groups-explain-terms.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/customer_groups/widgets/injection/person-groups-explain-terms.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'\nimport { apiCall, readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'\nimport { ErrorMessage, LoadingMessage } from '@open-mercato/ui/backend/detail'\nimport { SectionHeader } from '@open-mercato/ui/backend/SectionHeader'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('customer_groups').child({ component: 'PersonGroupsExplainTerms' })\n\ntype GroupSummary = { id: string; code: string; name: string }\n\ntype ExplainTermsField = {\n  value: string | number | boolean | null\n  sourceGroupId: string | null\n  path: GroupSummary[]\n}\n\n// Mirrors the `GET /api/customer_groups/customer-groups/explain-terms` response shape (see the\n// route's own `ExplainTermsResponse`/`ExplainTermsField` types) \u2014 kept as a local\n// client-side copy since API route modules are server-only and not importable here.\ntype ExplainTermsResponse = {\n  groups: GroupSummary[]\n  fields: {\n    priceKindId: ExplainTermsField\n    paymentTermsDays: ExplainTermsField\n    allowPurchaseOnAccount: ExplainTermsField\n    approvalRequiredAbove: ExplainTermsField\n    minOrderValue: ExplainTermsField\n  }\n}\n\nconst TERMS_FIELD_ORDER = [\n  'priceKindId',\n  'paymentTermsDays',\n  'allowPurchaseOnAccount',\n  'approvalRequiredAbove',\n  'minOrderValue',\n] as const\n\ntype TermsFieldKey = (typeof TERMS_FIELD_ORDER)[number]\n\nconst FIELD_LABEL_KEYS: Record<TermsFieldKey, [string, string]> = {\n  priceKindId: ['customer_groups.groups.personTab.explainTerms.field.priceKindId', 'Price kind'],\n  paymentTermsDays: ['customer_groups.groups.personTab.explainTerms.field.paymentTermsDays', 'Payment terms'],\n  allowPurchaseOnAccount: [\n    'customer_groups.groups.personTab.explainTerms.field.allowPurchaseOnAccount',\n    'Allow purchase on account',\n  ],\n  approvalRequiredAbove: [\n    'customer_groups.groups.personTab.explainTerms.field.approvalRequiredAbove',\n    'Approval required above',\n  ],\n  minOrderValue: ['customer_groups.groups.personTab.explainTerms.field.minOrderValue', 'Minimum order value'],\n}\n\nfunction pickString(item: Record<string, unknown>, ...keys: string[]): string {\n  for (const key of keys) {\n    const value = item[key]\n    if (typeof value === 'string' && value.length) return value\n  }\n  return ''\n}\n\n// Mirrors `resolvePriceKindLabel` in `../../components/CustomerGroupTermsPriceKindField.tsx`\n// \u2014 that file's helper is an unexported implementation detail of its combobox, and\n// this panel is read-only display (no combobox), so the same `/api/catalog/price-kinds?ids=`\n// lookup is re-implemented locally rather than imported.\nasync function resolvePriceKindLabel(id: string): Promise<string> {\n  try {\n    const params = new URLSearchParams({ ids: id, pageSize: '1' })\n    const payload = await readApiResultOrThrow<{ items?: Record<string, unknown>[] }>(\n      `/api/catalog/price-kinds?${params.toString()}`,\n      undefined,\n      { fallback: { items: [] } },\n    )\n    const items = Array.isArray(payload.items) ? payload.items : []\n    const item = items[0]\n    if (!item) return id\n    const title = pickString(item, 'title') || id\n    const code = pickString(item, 'code')\n    return code ? `${title} (${code})` : title\n  } catch (err) {\n    logger.error('customer_groups.explainTerms.priceKind.resolve', { err })\n    return id\n  }\n}\n\nfunction formatFieldValue(\n  field: TermsFieldKey,\n  entry: ExplainTermsField,\n  priceKindLabels: Record<string, string>,\n  t: TranslateFn,\n): string {\n  const notSet = t('customer_groups.groups.personTab.explainTerms.notSet', 'Not set')\n  if (field === 'priceKindId') {\n    if (typeof entry.value !== 'string' || !entry.value) return notSet\n    return priceKindLabels[entry.value] ?? entry.value\n  }\n  if (field === 'paymentTermsDays') {\n    if (typeof entry.value !== 'number') return notSet\n    return t('customer_groups.groups.personTab.explainTerms.value.days', '{count} days', { count: entry.value })\n  }\n  if (field === 'allowPurchaseOnAccount') {\n    if (typeof entry.value !== 'boolean') return notSet\n    return entry.value\n      ? t('customer_groups.groups.personTab.explainTerms.value.yes', 'Yes')\n      : t('customer_groups.groups.personTab.explainTerms.value.no', 'No')\n  }\n  // approvalRequiredAbove / minOrderValue\n  if (typeof entry.value !== 'number') return notSet\n  return String(entry.value)\n}\n\nfunction formatSourceLabel(entry: ExplainTermsField, t: TranslateFn): string {\n  if (entry.sourceGroupId == null) {\n    return t('customer_groups.groups.personTab.explainTerms.tenantDefault', 'Tenant default')\n  }\n  const path = entry.path.map((group) => `${group.name} (${group.code})`).join(' \u2192 ')\n  return t('customer_groups.groups.personTab.explainTerms.viaPath', 'via {path}', { path })\n}\n\nfunction ExplainTermsRow({\n  field,\n  entry,\n  priceKindLabels,\n}: {\n  field: TermsFieldKey\n  entry: ExplainTermsField\n  priceKindLabels: Record<string, string>\n}) {\n  const t = useT()\n  const [labelKey, labelFallback] = FIELD_LABEL_KEYS[field]\n  const fieldLabel = t(labelKey, labelFallback)\n  const valueLabel = formatFieldValue(field, entry, priceKindLabels, t)\n  const sourceLabel = formatSourceLabel(entry, t)\n\n  return (\n    <li className=\"rounded-md border border-border bg-card px-3 py-2\">\n      <div className=\"flex flex-wrap items-baseline justify-between gap-2\">\n        <span className=\"text-sm font-medium text-foreground\">{fieldLabel}</span>\n        <span className=\"text-sm text-foreground\">{valueLabel}</span>\n      </div>\n      <div className=\"text-xs text-muted-foreground\">{sourceLabel}</div>\n    </li>\n  )\n}\n\nexport function PersonGroupsExplainTerms({\n  customerId,\n  refreshKey = 0,\n}: {\n  customerId: string\n  refreshKey?: number\n}) {\n  const t = useT()\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n  const [data, setData] = React.useState<ExplainTermsResponse | null>(null)\n  const [priceKindLabels, setPriceKindLabels] = React.useState<Record<string, string>>({})\n\n  React.useEffect(() => {\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n    apiCall<ExplainTermsResponse>(`/api/customer_groups/customer-groups/explain-terms?customerId=${encodeURIComponent(customerId)}`)\n      .then((res) => {\n        if (cancelled) return\n        if (res.ok && res.result) {\n          setData(res.result)\n        } else if (res.status === 403) {\n          setData(null)\n        } else {\n          throw new Error('[internal] explain-terms')\n        }\n      })\n      .catch(() => {\n        if (!cancelled) {\n          setError(\n            t('customer_groups.groups.personTab.explainTerms.errors.load', 'Failed to load resolved terms.'),\n          )\n        }\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false)\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [customerId, refreshKey, t])\n\n  const priceKindId = data?.fields.priceKindId.value\n  React.useEffect(() => {\n    let cancelled = false\n    if (typeof priceKindId !== 'string' || !priceKindId) return\n    resolvePriceKindLabel(priceKindId).then((label) => {\n      if (!cancelled) setPriceKindLabels((prev) => (prev[priceKindId] ? prev : { ...prev, [priceKindId]: label }))\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [priceKindId])\n\n  if (loading) {\n    return <LoadingMessage label={t('customer_groups.groups.personTab.explainTerms.loading', 'Loading resolved terms\u2026')} />\n  }\n  if (error) return <ErrorMessage label={error} />\n  if (!data) return null\n\n  return (\n    <div className=\"space-y-3 border-t border-border pt-3\">\n      <SectionHeader title={t('customer_groups.groups.personTab.explainTerms.title', 'Explain terms')} />\n      <ul\n        className=\"space-y-2\"\n        aria-label={t('customer_groups.groups.personTab.explainTerms.listLabel', 'Resolved commercial terms')}\n      >\n        {TERMS_FIELD_ORDER.map((field) => (\n          <ExplainTermsRow key={field} field={field} entry={data.fields[field]} priceKindLabels={priceKindLabels} />\n        ))}\n      </ul>\n    </div>\n  )\n}\n\nexport default PersonGroupsExplainTerms\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/customer_groups/widgets/injection/person-groups-tab/widget.js

@@ -0,0 +1,17 @@
+import PersonGroupsTabWidget from "../person-groups-tab.js";
+const widget = {
+  metadata: {
+    id: "customer_groups.injection.person-groups-tab",
+    title: "Groups",
+    description: "Customer group memberships for the current customer",
+    features: ["customer_groups.memberships.view"],
+    priority: 45,
+    enabled: true
+  },
+  Widget: PersonGroupsTabWidget
+};
+var widget_default = widget;
+export {
+  widget_default as default
+};
+//# sourceMappingURL=widget.js.map

package/dist/modules/customer_groups/widgets/injection/person-groups-tab/widget.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/customer_groups/widgets/injection/person-groups-tab/widget.ts"],
+  "sourcesContent": ["import type { InjectionWidgetModule } from '@open-mercato/shared/modules/widgets/injection'\nimport PersonGroupsTabWidget from '../person-groups-tab'\n\ntype PersonGroupsTabContext = {\n  resourceKind: string\n  resourceId: string\n}\n\nconst widget: InjectionWidgetModule<PersonGroupsTabContext, unknown> = {\n  metadata: {\n    id: 'customer_groups.injection.person-groups-tab',\n    title: 'Groups',\n    description: 'Customer group memberships for the current customer',\n    features: ['customer_groups.memberships.view'],\n    priority: 45,\n    enabled: true,\n  },\n  Widget: PersonGroupsTabWidget,\n}\n\nexport default widget\n"],
+  "mappings": "AACA,OAAO,2BAA2B;AAOlC,MAAM,SAAiE;AAAA,EACrE,UAAU;AAAA,IACR,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU,CAAC,kCAAkC;AAAA,IAC7C,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AAAA,EACA,QAAQ;AACV;AAEA,IAAO,iBAAQ;",
+  "names": []
+}