@open-mercato/core 0.9.1-develop.7473.1.de5b22888f → 0.9.1-develop.7475.1.28ca93ed97

package/dist/modules/ecommerce/lib/storeNotifications.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ecommerce/lib/storeNotifications.ts"],
+  "sourcesContent": ["import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'\nimport type { NotificationService } from '../../notifications/lib/notificationService'\nimport { E } from '#generated/entities.ids.generated'\nimport { notificationTypes } from '../notifications'\nimport {\n  asPayloadRecord,\n  readEventScope,\n  readPayloadString,\n  tryResolveService,\n  type EcommerceSubscriberContext,\n} from './subscriberSupport'\n\n/**\n * Store-manager alerts (SPEC-029 \u00A79.4) delivered through `NotificationService.createForFeature`.\n * Emitters already throttle per hour; the `groupKey` (store + UTC hour) additionally makes a\n * retried or duplicated delivery refresh the recipient's existing notification instead of adding one.\n */\n\nexport const STORE_NOTIFICATION_FEATURE = 'ecommerce.stores.manage'\n\nexport type StoreNotificationType = 'ecommerce.store.channel_binding_missing' | 'ecommerce.store.assortment_empty'\n\ntype FeatureNotifier = Pick<NotificationService, 'createForFeature'>\n\nexport function storeNotificationGroupKey(storeId: string, now: Date): string {\n  return `${storeId}:${now.toISOString().slice(0, 13)}`\n}\n\nexport async function notifyStoreManagers(\n  payload: unknown,\n  ctx: EcommerceSubscriberContext,\n  type: StoreNotificationType,\n  now: Date = new Date(),\n): Promise<boolean> {\n  const record = asPayloadRecord(payload)\n  const storeId = readPayloadString(record, 'storeId') ?? readPayloadString(record, 'id')\n  const { tenantId, organizationId } = readEventScope(record, ctx)\n  if (!storeId || !tenantId || !organizationId) return false\n  const notificationService = tryResolveService<FeatureNotifier>(ctx, 'notificationService')\n  if (!notificationService) return false\n  const typeDef = notificationTypes.find((definition) => definition.type === type)\n  if (!typeDef) return false\n  const input = buildFeatureNotificationFromType(typeDef, {\n    requiredFeature: STORE_NOTIFICATION_FEATURE,\n    sourceEntityType: E.ecommerce.ecommerce_store,\n    sourceEntityId: storeId,\n    linkHref: `/backend/config/ecommerce/${encodeURIComponent(storeId)}`,\n    groupKey: storeNotificationGroupKey(storeId, now),\n  })\n  await notificationService.createForFeature(\n    { ...input, restrictRecipientsToOrganization: true },\n    { tenantId, organizationId },\n  )\n  return true\n}\n"],
+  "mappings": "AAAA,SAAS,wCAAwC;AAEjD,SAAS,SAAS;AAClB,SAAS,yBAAyB;AAClC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAQA,MAAM,6BAA6B;AAMnC,SAAS,0BAA0B,SAAiB,KAAmB;AAC5E,SAAO,GAAG,OAAO,IAAI,IAAI,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AACrD;AAEA,eAAsB,oBACpB,SACA,KACA,MACA,MAAY,oBAAI,KAAK,GACH;AAClB,QAAM,SAAS,gBAAgB,OAAO;AACtC,QAAM,UAAU,kBAAkB,QAAQ,SAAS,KAAK,kBAAkB,QAAQ,IAAI;AACtF,QAAM,EAAE,UAAU,eAAe,IAAI,eAAe,QAAQ,GAAG;AAC/D,MAAI,CAAC,WAAW,CAAC,YAAY,CAAC,eAAgB,QAAO;AACrD,QAAM,sBAAsB,kBAAmC,KAAK,qBAAqB;AACzF,MAAI,CAAC,oBAAqB,QAAO;AACjC,QAAM,UAAU,kBAAkB,KAAK,CAAC,eAAe,WAAW,SAAS,IAAI;AAC/E,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,QAAQ,iCAAiC,SAAS;AAAA,IACtD,iBAAiB;AAAA,IACjB,kBAAkB,EAAE,UAAU;AAAA,IAC9B,gBAAgB;AAAA,IAChB,UAAU,6BAA6B,mBAAmB,OAAO,CAAC;AAAA,IAClE,UAAU,0BAA0B,SAAS,GAAG;AAAA,EAClD,CAAC;AACD,QAAM,oBAAoB;AAAA,IACxB,EAAE,GAAG,OAAO,kCAAkC,KAAK;AAAA,IACnD,EAAE,UAAU,eAAe;AAAA,EAC7B;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/ecommerce/lib/storefrontCatalogSupport.js

@@ -0,0 +1,248 @@
+import { sql } from "kysely";
+import {
+  availabilityItemKey,
+  resolveAvailability
+} from "@open-mercato/shared/lib/availability";
+import { parseBooleanFromUnknown } from "@open-mercato/shared/lib/boolean";
+import { findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { getTelemetryRuntime } from "@open-mercato/shared/lib/telemetry/runtime";
+import { AttachmentPartition } from "@open-mercato/core/modules/attachments/data/entities";
+import { CatalogProductCategory } from "@open-mercato/core/modules/catalog/data/entities";
+import { batchLoadTranslationsMany } from "@open-mercato/core/modules/translations/lib/batch";
+const logger = createLogger("ecommerce");
+const STOREFRONT_PRODUCT_ENTITY_TYPE = "catalog:catalog_product";
+const STOREFRONT_VARIANT_ENTITY_TYPE = "catalog:catalog_product_variant";
+const STOREFRONT_CATEGORY_ENTITY_TYPE = "catalog:catalog_product_category";
+const STOREFRONT_TAG_ENTITY_TYPE = "catalog:catalog_product_tag";
+const STOREFRONT_OPTION_SCHEMA_ENTITY_TYPE = "catalog:catalog_option_schema_template";
+function tryResolve(container, name) {
+  try {
+    return container.resolve(name) ?? null;
+  } catch {
+    return null;
+  }
+}
+function referenceId(value) {
+  if (typeof value === "string") return value.length ? value : null;
+  if (value && typeof value === "object" && "id" in value) {
+    const id = value.id;
+    return typeof id === "string" && id.length ? id : null;
+  }
+  return null;
+}
+function stringList(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.length > 0) : [];
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function categoryBranchAdmits(branch, lineage, reach) {
+  const included = stringList(branch.categoryIds);
+  if (included.length > 0 && !included.some((id) => reach.has(id))) return false;
+  if (stringList(branch.excludeCategoryIds).some((id) => lineage.has(id))) return false;
+  return (branch.allOf ?? []).every((nested) => categoryBranchAdmits(nested, lineage, reach));
+}
+function isCategoryInAssortment(category, scope) {
+  if (scope === null) return true;
+  const lineage = /* @__PURE__ */ new Set([category.id, ...category.ancestorIds]);
+  const reach = /* @__PURE__ */ new Set([...lineage, ...category.descendantIds]);
+  return scope.some((branch) => categoryBranchAdmits(branch, lineage, reach));
+}
+async function selectCategoriesWithActiveAncestors(em, ctx, categories, known = {}) {
+  const ancestors = new Map(known.ancestors ?? []);
+  const active = /* @__PURE__ */ new Set([...known.activeIds ?? [], ...ancestors.keys()]);
+  const unknown = Array.from(
+    new Set(categories.flatMap((category) => category.ancestorIds.filter((id) => !active.has(id))))
+  );
+  if (unknown.length > 0) {
+    const rows = await findWithDecryption(
+      em,
+      CatalogProductCategory,
+      { id: { $in: unknown }, tenantId: ctx.tenantId, organizationId: ctx.organizationId, deletedAt: null, isActive: true },
+      { fields: ["id", "name", "slug", "ancestorIds"] },
+      { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    );
+    for (const row of rows) {
+      active.add(row.id);
+      ancestors.set(row.id, { id: row.id, name: row.name, slug: row.slug ?? null, ancestorIds: stringList(row.ancestorIds) });
+    }
+  }
+  const visibleIds = new Set(
+    categories.filter((category) => category.ancestorIds.every((id) => active.has(id))).map((category) => category.id)
+  );
+  return { visibleIds, ancestors };
+}
+function localize(base, translations, field, locales) {
+  for (const locale of locales) {
+    const value = nonEmptyString(translations?.[locale]?.[field]);
+    if (value !== null) return value;
+  }
+  return nonEmptyString(base);
+}
+function localeChain(ctx, preferredLocale) {
+  const head = preferredLocale && ctx.store.supportedLocales.includes(preferredLocale) ? preferredLocale : ctx.effectiveLocale;
+  return Array.from(new Set([head, ctx.store.defaultLocale].filter((locale) => !!locale)));
+}
+function toStorefrontAvailability(result) {
+  if (!result) return { state: "not_tracked", canFulfil: true, leadTimeDays: null, releaseAt: null };
+  return {
+    state: result.state,
+    canFulfil: result.canFulfil,
+    leadTimeDays: result.leadTimeDays,
+    releaseAt: result.releaseAt
+  };
+}
+function storefrontAvailabilityKey(target) {
+  return availabilityItemKey({ catalogProductId: target.productId, catalogVariantId: target.variantId });
+}
+async function resolveStorefrontAvailability(container, ctx, em, targets) {
+  const results = /* @__PURE__ */ new Map();
+  if (!targets.length) return results;
+  const items = targets.map((target) => ({
+    catalogProductId: target.productId,
+    catalogVariantId: target.variantId,
+    quantity: 1
+  }));
+  const moduleConfig = tryResolve(container, "moduleConfigService");
+  const policyResolver = tryResolve(container, "policyResolutionService");
+  const [availability, policies] = await Promise.all([
+    resolveAvailability(
+      {
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId,
+        storeId: ctx.store.id,
+        channelId: ctx.channel?.salesChannelId ?? null,
+        items
+      },
+      moduleConfig ? { moduleConfig, container } : { container }
+    ),
+    policyResolver ? policyResolver.resolveMany(
+      em,
+      targets.map((target) => ({
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId,
+        storeId: ctx.store.id,
+        productId: target.productId,
+        variantId: target.variantId
+      }))
+    ) : Promise.resolve([])
+  ]);
+  targets.forEach((target, index) => {
+    const key = storefrontAvailabilityKey(target);
+    results.set(key, { result: availability.byItem[key] ?? null, policy: policies[index] ?? null });
+  });
+  return results;
+}
+async function loadStorefrontTranslations(em, ctx, requests) {
+  const pending = requests.filter((request) => request.ids.length > 0);
+  if (!pending.length) return /* @__PURE__ */ new Map();
+  try {
+    return await batchLoadTranslationsMany(
+      em.getKysely(),
+      pending.map((request) => ({ entityType: request.entityType, entityIds: request.ids })),
+      { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    );
+  } catch (err) {
+    logger.error("[internal] ecommerce storefront translation overlay failed", {
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId,
+      storeId: ctx.store.id,
+      err
+    });
+    getTelemetryRuntime()?.reportError(err, {
+      module: "ecommerce",
+      code: "ecommerce.storefront_translations_failed",
+      attributes: { entityTypes: pending.length }
+    });
+    return /* @__PURE__ */ new Map();
+  }
+}
+function isImageMimeType(mimeType) {
+  return typeof mimeType === "string" && mimeType.trim().toLowerCase().startsWith("image/");
+}
+async function loadPublicPartitionCodes(em, ctx, codes) {
+  if (!codes.length) return /* @__PURE__ */ new Set();
+  const partitions = await findWithDecryption(
+    em,
+    AttachmentPartition,
+    {
+      code: { $in: codes },
+      isPublic: true,
+      $and: [
+        { $or: [{ tenantId: null }, { tenantId: ctx.tenantId }] },
+        { $or: [{ organizationId: null }, { organizationId: ctx.organizationId }] }
+      ]
+    },
+    { fields: ["id", "code"] },
+    { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+  );
+  return new Set(partitions.map((partition) => partition.code));
+}
+async function resolvePublicDefaultMediaUrls(em, ctx, refs) {
+  const urls = /* @__PURE__ */ new Map();
+  const pending = [];
+  for (const ref of refs) {
+    urls.set(ref.id, null);
+    const url = nonEmptyString(ref.defaultMediaUrl);
+    const mediaId = nonEmptyString(ref.defaultMediaId);
+    if (url && mediaId) pending.push({ productId: ref.id, mediaId, url });
+  }
+  if (!pending.length) return urls;
+  const mediaIds = Array.from(new Set(pending.map((entry) => entry.mediaId)));
+  const rows = await em.getKysely().selectFrom("attachments as a").innerJoin("attachment_partitions as p", "p.code", "a.partition_code").select(["a.id as id", "a.mime_type as mime_type"]).where(sql`${sql.ref("a.id")} = any(${mediaIds}::uuid[])`).where("a.tenant_id", "=", ctx.tenantId).where("a.organization_id", "=", ctx.organizationId).where("p.is_public", "=", true).where((eb) => eb.or([eb("p.tenant_id", "is", null), eb("p.tenant_id", "=", ctx.tenantId)])).where((eb) => eb.or([eb("p.organization_id", "is", null), eb("p.organization_id", "=", ctx.organizationId)])).execute();
+  const publicIds = new Set(rows.filter((row) => isImageMimeType(row.mime_type)).map((row) => row.id));
+  for (const entry of pending) if (publicIds.has(entry.mediaId)) urls.set(entry.productId, entry.url);
+  return urls;
+}
+function buildStorefrontListItem(source, parts) {
+  const { locales, overlay } = parts;
+  const price = parts.pricing?.price ?? null;
+  return {
+    id: source.id,
+    handle: nonEmptyString(source.handle),
+    title: localize(source.title, overlay, "title", locales) ?? "",
+    subtitle: localize(source.subtitle, overlay, "subtitle", locales),
+    defaultMediaUrl: nonEmptyString(source.defaultMediaUrl),
+    productType: nonEmptyString(source.productType) ?? "simple",
+    isConfigurable: parseBooleanFromUnknown(source.isConfigurable) === true,
+    hasVariants: parts.variantCount > 0,
+    variantCount: parts.variantCount,
+    categories: parts.categories.map((category) => ({
+      id: category.id,
+      name: localize(category.name, parts.categoryTranslations?.get(category.id), "name", locales) ?? category.name,
+      slug: category.slug
+    })),
+    tags: parts.tags.map(
+      (tag) => localize(tag.label, parts.tagTranslations?.get(tag.id), "label", locales) ?? tag.label
+    ),
+    price,
+    priceRange: parts.pricing?.priceRange ?? null,
+    availability: parts.availability,
+    badges: price?.isPromotion ? ["sale"] : []
+  };
+}
+export {
+  STOREFRONT_CATEGORY_ENTITY_TYPE,
+  STOREFRONT_OPTION_SCHEMA_ENTITY_TYPE,
+  STOREFRONT_PRODUCT_ENTITY_TYPE,
+  STOREFRONT_TAG_ENTITY_TYPE,
+  STOREFRONT_VARIANT_ENTITY_TYPE,
+  buildStorefrontListItem,
+  isCategoryInAssortment,
+  isImageMimeType,
+  loadPublicPartitionCodes,
+  loadStorefrontTranslations,
+  localeChain,
+  localize,
+  nonEmptyString,
+  referenceId,
+  resolvePublicDefaultMediaUrls,
+  resolveStorefrontAvailability,
+  selectCategoriesWithActiveAncestors,
+  storefrontAvailabilityKey,
+  stringList,
+  toStorefrontAvailability,
+  tryResolve
+};
+//# sourceMappingURL=storefrontCatalogSupport.js.map

package/dist/modules/ecommerce/lib/storefrontCatalogSupport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ecommerce/lib/storefrontCatalogSupport.ts"],
+  "sourcesContent": ["import type { AwilixContainer } from 'awilix'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { sql } from 'kysely'\nimport {\n  availabilityItemKey,\n  resolveAvailability,\n  type AvailabilityItemResult,\n  type AvailabilityModuleConfigReader,\n  type AvailabilityState,\n} from '@open-mercato/shared/lib/availability'\nimport { parseBooleanFromUnknown } from '@open-mercato/shared/lib/boolean'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { AssortmentScope, EffectiveAssortmentScope } from '@open-mercato/shared/lib/catalog-visibility'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'\nimport { AttachmentPartition } from '@open-mercato/core/modules/attachments/data/entities'\nimport { CatalogProductCategory } from '@open-mercato/core/modules/catalog/data/entities'\nimport { batchLoadTranslationsMany } from '@open-mercato/core/modules/translations/lib/batch'\nimport type { StorefrontPrice, StorefrontPriceRange, StorefrontProductPricing } from './storefrontPricing'\nimport type { StoreContext } from './types'\n\nconst logger = createLogger('ecommerce')\n\nexport const STOREFRONT_PRODUCT_ENTITY_TYPE = 'catalog:catalog_product'\nexport const STOREFRONT_VARIANT_ENTITY_TYPE = 'catalog:catalog_product_variant'\nexport const STOREFRONT_CATEGORY_ENTITY_TYPE = 'catalog:catalog_product_category'\nexport const STOREFRONT_TAG_ENTITY_TYPE = 'catalog:catalog_product_tag'\nexport const STOREFRONT_OPTION_SCHEMA_ENTITY_TYPE = 'catalog:catalog_option_schema_template'\n\nexport type StorefrontAvailability = {\n  state: AvailabilityState\n  canFulfil: boolean\n  leadTimeDays: number | null\n  releaseAt: string | null\n}\n\nexport type StorefrontProductListItem = {\n  id: string\n  handle: string | null\n  title: string\n  subtitle: string | null\n  defaultMediaUrl: string | null\n  productType: string\n  isConfigurable: boolean\n  hasVariants: boolean\n  variantCount: number\n  categories: Array<{ id: string; name: string; slug: string | null }>\n  tags: string[]\n  price: StorefrontPrice | null\n  priceRange: StorefrontPriceRange | null\n  availability: StorefrontAvailability\n  badges: string[]\n}\n\nexport type CategoryLineage = { id: string; ancestorIds: string[]; descendantIds: string[] }\n\nexport type CategoryRef = { id: string; name: string; slug: string | null }\n\nexport type TagRef = { id: string; label: string }\n\nexport type TranslationOverlay = Record<string, Record<string, unknown>>\n\nexport type TranslationMap = Map<string, TranslationOverlay>\n\nexport type StorefrontPolicyResolutionScope = {\n  tenantId: string\n  organizationId: string\n  storeId: string | null\n  productId: string\n  variantId: string | null\n}\n\ntype ResolvedPolicyField<T> = { value: T } | null | undefined\n\nexport type StorefrontResolvedPolicy = {\n  hideWhenOutOfStock?: ResolvedPolicyField<boolean>\n  minOrderQuantity?: ResolvedPolicyField<number | null>\n  maxOrderQuantity?: ResolvedPolicyField<number | null>\n  quantityIncrement?: ResolvedPolicyField<number | null>\n}\n\nexport type StorefrontPolicyResolver = {\n  resolveMany(\n    em: EntityManager,\n    scopes: StorefrontPolicyResolutionScope[],\n  ): Promise<Array<StorefrontResolvedPolicy | null | undefined>>\n}\n\nexport type StorefrontAvailabilityTarget = { productId: string; variantId: string | null }\n\nexport type ResolvedStorefrontAvailability = {\n  result: AvailabilityItemResult | null\n  policy: StorefrontResolvedPolicy | null\n}\n\nexport function tryResolve<T>(container: AwilixContainer, name: string): T | null {\n  try {\n    return (container.resolve(name) as T | null | undefined) ?? null\n  } catch {\n    return null\n  }\n}\n\nexport function referenceId(value: unknown): string | null {\n  if (typeof value === 'string') return value.length ? value : null\n  if (value && typeof value === 'object' && 'id' in value) {\n    const id = (value as { id: unknown }).id\n    return typeof id === 'string' && id.length ? id : null\n  }\n  return null\n}\n\nexport function stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string' && entry.length > 0) : []\n}\n\nexport function nonEmptyString(value: unknown): string | null {\n  return typeof value === 'string' && value.trim().length > 0 ? value : null\n}\n\nfunction categoryBranchAdmits(branch: AssortmentScope, lineage: Set<string>, reach: Set<string>): boolean {\n  const included = stringList(branch.categoryIds)\n  if (included.length > 0 && !included.some((id) => reach.has(id))) return false\n  if (stringList(branch.excludeCategoryIds).some((id) => lineage.has(id))) return false\n  return (branch.allOf ?? []).every((nested) => categoryBranchAdmits(nested, lineage, reach))\n}\n\n/**\n * Whether a category can hold any product the effective assortment admits: one of its own subtree\n * or ancestors is granted by some branch, and neither it nor an ancestor is excluded there. Tag and\n * product conditions are product-level and do not decide a category's visibility.\n */\nexport function isCategoryInAssortment(category: CategoryLineage, scope: EffectiveAssortmentScope): boolean {\n  if (scope === null) return true\n  const lineage = new Set([category.id, ...category.ancestorIds])\n  const reach = new Set([...lineage, ...category.descendantIds])\n  return scope.some((branch) => categoryBranchAdmits(branch, lineage, reach))\n}\n\nexport type ActiveCategoryAncestor = { id: string; name: string; slug: string | null; ancestorIds: string[] }\n\n/**\n * Which of the given categories have every ancestor active and not deleted \u2014 the rule the category\n * tree applies, so a category hidden there under an inactive parent is hidden everywhere. Ancestors\n * listed in `known` (already checked active) need no lookup; the rest cost one categories query, and\n * none when every category is a root or has only known ancestors. `ancestors` holds the active\n * ancestor rows, fetched and known, for callers that render them (breadcrumbs).\n */\nexport async function selectCategoriesWithActiveAncestors(\n  em: EntityManager,\n  ctx: Pick<StoreContext, 'tenantId' | 'organizationId'>,\n  categories: Array<{ id: string; ancestorIds: string[] }>,\n  known: { activeIds?: Iterable<string>; ancestors?: Map<string, ActiveCategoryAncestor> } = {},\n): Promise<{ visibleIds: Set<string>; ancestors: Map<string, ActiveCategoryAncestor> }> {\n  const ancestors = new Map(known.ancestors ?? [])\n  const active = new Set([...(known.activeIds ?? []), ...ancestors.keys()])\n  const unknown = Array.from(\n    new Set(categories.flatMap((category) => category.ancestorIds.filter((id) => !active.has(id)))),\n  )\n  if (unknown.length > 0) {\n    const rows = await findWithDecryption(\n      em,\n      CatalogProductCategory,\n      { id: { $in: unknown }, tenantId: ctx.tenantId, organizationId: ctx.organizationId, deletedAt: null, isActive: true },\n      { fields: ['id', 'name', 'slug', 'ancestorIds'] },\n      { tenantId: ctx.tenantId, organizationId: ctx.organizationId },\n    )\n    for (const row of rows) {\n      active.add(row.id)\n      ancestors.set(row.id, { id: row.id, name: row.name, slug: row.slug ?? null, ancestorIds: stringList(row.ancestorIds) })\n    }\n  }\n  const visibleIds = new Set(\n    categories.filter((category) => category.ancestorIds.every((id) => active.has(id))).map((category) => category.id),\n  )\n  return { visibleIds, ancestors }\n}\n\nexport function localize(\n  base: unknown,\n  translations: TranslationOverlay | undefined,\n  field: string,\n  locales: string[],\n): string | null {\n  for (const locale of locales) {\n    const value = nonEmptyString(translations?.[locale]?.[field])\n    if (value !== null) return value\n  }\n  return nonEmptyString(base)\n}\n\nexport function localeChain(ctx: StoreContext, preferredLocale?: string | null): string[] {\n  const head = preferredLocale && ctx.store.supportedLocales.includes(preferredLocale) ? preferredLocale : ctx.effectiveLocale\n  return Array.from(new Set([head, ctx.store.defaultLocale].filter((locale): locale is string => !!locale)))\n}\n\nexport function toStorefrontAvailability(result: AvailabilityItemResult | null): StorefrontAvailability {\n  if (!result) return { state: 'not_tracked', canFulfil: true, leadTimeDays: null, releaseAt: null }\n  return {\n    state: result.state,\n    canFulfil: result.canFulfil,\n    leadTimeDays: result.leadTimeDays,\n    releaseAt: result.releaseAt,\n  }\n}\n\nexport function storefrontAvailabilityKey(target: StorefrontAvailabilityTarget): string {\n  return availabilityItemKey({ catalogProductId: target.productId, catalogVariantId: target.variantId })\n}\n\n/**\n * One batched `resolveAvailability` (state) and one `policyResolutionService.resolveMany` (quantity\n * rules, `hideWhenOutOfStock`) for every product and variant of a response, keyed by\n * `storefrontAvailabilityKey`. A missing policy service yields `policy: null`.\n */\nexport async function resolveStorefrontAvailability(\n  container: AwilixContainer,\n  ctx: StoreContext,\n  em: EntityManager,\n  targets: StorefrontAvailabilityTarget[],\n): Promise<Map<string, ResolvedStorefrontAvailability>> {\n  const results = new Map<string, ResolvedStorefrontAvailability>()\n  if (!targets.length) return results\n  const items = targets.map((target) => ({\n    catalogProductId: target.productId,\n    catalogVariantId: target.variantId,\n    quantity: 1,\n  }))\n  const moduleConfig = tryResolve<AvailabilityModuleConfigReader>(container, 'moduleConfigService')\n  const policyResolver = tryResolve<StorefrontPolicyResolver>(container, 'policyResolutionService')\n  const [availability, policies] = await Promise.all([\n    resolveAvailability(\n      {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId,\n        storeId: ctx.store.id,\n        channelId: ctx.channel?.salesChannelId ?? null,\n        items,\n      },\n      moduleConfig ? { moduleConfig, container } : { container },\n    ),\n    policyResolver\n      ? policyResolver.resolveMany(\n          em,\n          targets.map((target) => ({\n            tenantId: ctx.tenantId,\n            organizationId: ctx.organizationId,\n            storeId: ctx.store.id,\n            productId: target.productId,\n            variantId: target.variantId,\n          })),\n        )\n      : Promise.resolve([]),\n  ])\n  targets.forEach((target, index) => {\n    const key = storefrontAvailabilityKey(target)\n    results.set(key, { result: availability.byItem[key] ?? null, policy: policies[index] ?? null })\n  })\n  return results\n}\n\n/**\n * The response's translation overlays in one query (Storefront Public API \u00A77.2: one call per\n * response), keyed by entity type. A failure degrades to base fields and is reported.\n */\nexport async function loadStorefrontTranslations(\n  em: EntityManager,\n  ctx: StoreContext,\n  requests: Array<{ entityType: string; ids: string[] }>,\n): Promise<Map<string, TranslationMap>> {\n  const pending = requests.filter((request) => request.ids.length > 0)\n  if (!pending.length) return new Map()\n  try {\n    return await batchLoadTranslationsMany(\n      em.getKysely(),\n      pending.map((request) => ({ entityType: request.entityType, entityIds: request.ids })),\n      { tenantId: ctx.tenantId, organizationId: ctx.organizationId },\n    )\n  } catch (err) {\n    logger.error('[internal] ecommerce storefront translation overlay failed', {\n      tenantId: ctx.tenantId,\n      organizationId: ctx.organizationId,\n      storeId: ctx.store.id,\n      err,\n    })\n    getTelemetryRuntime()?.reportError(err, {\n      module: 'ecommerce',\n      code: 'ecommerce.storefront_translations_failed',\n      attributes: { entityTypes: pending.length },\n    })\n    return new Map()\n  }\n}\n\nexport function isImageMimeType(mimeType: string | null | undefined): boolean {\n  return typeof mimeType === 'string' && mimeType.trim().toLowerCase().startsWith('image/')\n}\n\n/** The codes among `codes` naming a public attachment partition visible to the store's tenant and organization. */\nexport async function loadPublicPartitionCodes(em: EntityManager, ctx: StoreContext, codes: string[]): Promise<Set<string>> {\n  if (!codes.length) return new Set()\n  const partitions = await findWithDecryption(\n    em,\n    AttachmentPartition,\n    {\n      code: { $in: codes },\n      isPublic: true,\n      $and: [\n        { $or: [{ tenantId: null }, { tenantId: ctx.tenantId }] },\n        { $or: [{ organizationId: null }, { organizationId: ctx.organizationId }] },\n      ],\n    },\n    { fields: ['id', 'code'] },\n    { tenantId: ctx.tenantId, organizationId: ctx.organizationId },\n  )\n  return new Set(partitions.map((partition) => partition.code))\n}\n\nexport type StorefrontDefaultMediaRef = { id: string; defaultMediaId?: unknown; defaultMediaUrl?: unknown }\n\ntype PublicMediaDatabase = {\n  attachments: {\n    id: string\n    tenant_id: string | null\n    organization_id: string | null\n    partition_code: string\n    mime_type: string\n  }\n  attachment_partitions: {\n    code: string\n    is_public: boolean\n    tenant_id: string | null\n    organization_id: string | null\n  }\n}\n\n/**\n * Card `defaultMediaUrl`s held to the gallery rule of the product detail: a product's stored URL is\n * returned only while its `defaultMediaId` names an `image/*` attachment of the store's tenant and\n * organization in a public partition; otherwise it is `null`. One query for the whole page (the\n * attachments joined to their partitions, plain non-encrypted columns), none when no product\n * carries a default media id.\n */\nexport async function resolvePublicDefaultMediaUrls(\n  em: EntityManager,\n  ctx: StoreContext,\n  refs: StorefrontDefaultMediaRef[],\n): Promise<Map<string, string | null>> {\n  const urls = new Map<string, string | null>()\n  const pending: Array<{ productId: string; mediaId: string; url: string }> = []\n  for (const ref of refs) {\n    urls.set(ref.id, null)\n    const url = nonEmptyString(ref.defaultMediaUrl)\n    const mediaId = nonEmptyString(ref.defaultMediaId)\n    if (url && mediaId) pending.push({ productId: ref.id, mediaId, url })\n  }\n  if (!pending.length) return urls\n  const mediaIds = Array.from(new Set(pending.map((entry) => entry.mediaId)))\n  const rows = await em\n    .getKysely<PublicMediaDatabase>()\n    .selectFrom('attachments as a')\n    .innerJoin('attachment_partitions as p', 'p.code', 'a.partition_code')\n    .select(['a.id as id', 'a.mime_type as mime_type'])\n    .where(sql<boolean>`${sql.ref('a.id')} = any(${mediaIds}::uuid[])`)\n    .where('a.tenant_id', '=', ctx.tenantId)\n    .where('a.organization_id', '=', ctx.organizationId)\n    .where('p.is_public', '=', true)\n    .where((eb) => eb.or([eb('p.tenant_id', 'is', null), eb('p.tenant_id', '=', ctx.tenantId)]))\n    .where((eb) => eb.or([eb('p.organization_id', 'is', null), eb('p.organization_id', '=', ctx.organizationId)]))\n    .execute()\n  const publicIds = new Set(rows.filter((row) => isImageMimeType(row.mime_type)).map((row) => row.id))\n  for (const entry of pending) if (publicIds.has(entry.mediaId)) urls.set(entry.productId, entry.url)\n  return urls\n}\n\nexport type StorefrontListItemSource = {\n  id: string\n  handle?: unknown\n  title?: unknown\n  subtitle?: unknown\n  defaultMediaUrl?: unknown\n  productType?: unknown\n  isConfigurable?: unknown\n}\n\nexport type StorefrontListItemParts = {\n  locales: string[]\n  overlay?: TranslationOverlay\n  variantCount: number\n  categories: CategoryRef[]\n  categoryTranslations?: TranslationMap\n  tags: TagRef[]\n  tagTranslations?: TranslationMap\n  pricing?: StorefrontProductPricing\n  availability: StorefrontAvailability\n}\n\nexport function buildStorefrontListItem(\n  source: StorefrontListItemSource,\n  parts: StorefrontListItemParts,\n): StorefrontProductListItem {\n  const { locales, overlay } = parts\n  const price = parts.pricing?.price ?? null\n  return {\n    id: source.id,\n    handle: nonEmptyString(source.handle),\n    title: localize(source.title, overlay, 'title', locales) ?? '',\n    subtitle: localize(source.subtitle, overlay, 'subtitle', locales),\n    defaultMediaUrl: nonEmptyString(source.defaultMediaUrl),\n    productType: nonEmptyString(source.productType) ?? 'simple',\n    isConfigurable: parseBooleanFromUnknown(source.isConfigurable) === true,\n    hasVariants: parts.variantCount > 0,\n    variantCount: parts.variantCount,\n    categories: parts.categories.map((category) => ({\n      id: category.id,\n      name: localize(category.name, parts.categoryTranslations?.get(category.id), 'name', locales) ?? category.name,\n      slug: category.slug,\n    })),\n    tags: parts.tags.map(\n      (tag) => localize(tag.label, parts.tagTranslations?.get(tag.id), 'label', locales) ?? tag.label,\n    ),\n    price,\n    priceRange: parts.pricing?.priceRange ?? null,\n    availability: parts.availability,\n    badges: price?.isPromotion ? ['sale'] : [],\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/ecommerce/lib/storefrontCategories.js

@@ -0,0 +1,241 @@
+import { sql } from "kysely";
+import { findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { CatalogProductCategory } from "@open-mercato/core/modules/catalog/data/entities";
+import { compareCodeUnits } from "@open-mercato/core/modules/catalog/lib/productScopeKeys";
+import {
+  STOREFRONT_CATEGORY_ENTITY_TYPE,
+  isCategoryInAssortment,
+  loadStorefrontTranslations,
+  localeChain,
+  localize,
+  stringList,
+  tryResolve
+} from "./storefrontCatalogSupport.js";
+import { queryStorefrontProductUniverse } from "./storefrontFacets.js";
+import { buildStorefrontProductScope } from "./storefrontProductScope.js";
+const EMPTY_SNAPSHOT = { visible: /* @__PURE__ */ new Map(), counts: /* @__PURE__ */ new Map() };
+function resolveRuntime(container, ctx) {
+  const em = tryResolve(container, "em");
+  const queryEngine = tryResolve(container, "queryEngine");
+  if (!em || !queryEngine) throw new Error("[internal] ecommerce storefront categories require em and queryEngine");
+  return {
+    ctx,
+    em,
+    queryEngine,
+    scope: buildStorefrontProductScope(ctx),
+    decryptionScope: { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+  };
+}
+function isDenyAll(ctx) {
+  const scope = ctx.buyer.assortmentScope;
+  return scope !== null && scope.length === 0;
+}
+async function loadCategoryRows(runtime) {
+  const { ctx } = runtime;
+  const rows = await findWithDecryption(
+    runtime.em,
+    CatalogProductCategory,
+    { tenantId: ctx.tenantId, organizationId: ctx.organizationId, deletedAt: null },
+    { fields: ["id", "name", "slug", "description", "depth", "parentId", "isActive", "ancestorIds", "descendantIds"] },
+    runtime.decryptionScope
+  );
+  return new Map(
+    rows.map((row) => [
+      row.id,
+      {
+        id: row.id,
+        name: row.name,
+        slug: row.slug ?? null,
+        description: row.description ?? null,
+        depth: typeof row.depth === "number" ? row.depth : 0,
+        parentId: row.parentId ?? null,
+        isActive: row.isActive !== false,
+        ancestorIds: stringList(row.ancestorIds),
+        descendantIds: stringList(row.descendantIds)
+      }
+    ])
+  );
+}
+function selectVisibleCategories(rows, ctx) {
+  const visible = /* @__PURE__ */ new Map();
+  for (const row of rows.values()) {
+    if (!row.isActive) continue;
+    if (!row.ancestorIds.every((id) => rows.get(id)?.isActive === true)) continue;
+    const lineage = { id: row.id, ancestorIds: row.ancestorIds, descendantIds: row.descendantIds };
+    if (!isCategoryInAssortment(lineage, ctx.buyer.assortmentScope)) continue;
+    visible.set(row.id, row);
+  }
+  return visible;
+}
+async function loadStorefrontVisibleCategories(runtime) {
+  return selectVisibleCategories(await loadCategoryRows(runtime), runtime.ctx);
+}
+async function loadAssignedCategoryIds(runtime, productIds) {
+  const { tenantId, organizationId } = runtime.decryptionScope;
+  const rows = await runtime.em.getKysely().selectFrom("catalog_product_category_assignments as ca").select(["ca.product_id as product_id", "ca.category_id as category_id"]).where(sql`${sql.ref("ca.product_id")} = any(${productIds}::uuid[])`).where("ca.tenant_id", "=", tenantId).where("ca.organization_id", "=", organizationId).execute();
+  const byProduct = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const bucket = byProduct.get(row.product_id) ?? [];
+    bucket.push(row.category_id);
+    byProduct.set(row.product_id, bucket);
+  }
+  return byProduct;
+}
+function countProductsPerCategory(assignedByProduct, ancestorsOf) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const assigned of assignedByProduct.values()) {
+    const reached = /* @__PURE__ */ new Set();
+    for (const categoryId of assigned) {
+      const ancestors = ancestorsOf(categoryId);
+      if (!ancestors) continue;
+      reached.add(categoryId);
+      for (const ancestorId of ancestors) reached.add(ancestorId);
+    }
+    for (const categoryId of reached) counts.set(categoryId, (counts.get(categoryId) ?? 0) + 1);
+  }
+  return counts;
+}
+async function loadCategoryCounts(runtime, rows, universe) {
+  if (universe === null) return null;
+  const productIds = Array.from(
+    new Set(universe.flatMap((record) => typeof record.id === "string" ? [record.id] : []))
+  );
+  if (productIds.length === 0) return /* @__PURE__ */ new Map();
+  const assigned = await loadAssignedCategoryIds(runtime, productIds);
+  return countProductsPerCategory(assigned, (categoryId) => rows.get(categoryId)?.ancestorIds ?? null);
+}
+async function loadCategorySnapshot(runtime, targetVisible) {
+  if (isDenyAll(runtime.ctx)) return EMPTY_SNAPSHOT;
+  if (targetVisible) {
+    const rows2 = await loadCategoryRows(runtime);
+    const visible2 = selectVisibleCategories(rows2, runtime.ctx);
+    if (visible2.size === 0 || !targetVisible(visible2)) return { visible: visible2, counts: /* @__PURE__ */ new Map() };
+    const universe2 = await queryStorefrontProductUniverse(runtime, runtime.scope.filters);
+    return { visible: visible2, counts: await loadCategoryCounts(runtime, rows2, universe2) };
+  }
+  const [rows, universe] = await Promise.all([
+    loadCategoryRows(runtime),
+    queryStorefrontProductUniverse(runtime, runtime.scope.filters)
+  ]);
+  const visible = selectVisibleCategories(rows, runtime.ctx);
+  if (visible.size === 0) return { visible, counts: /* @__PURE__ */ new Map() };
+  return { visible, counts: await loadCategoryCounts(runtime, rows, universe) };
+}
+function productCountOf(counts, id) {
+  return counts === null ? null : counts.get(id) ?? 0;
+}
+function isNonEmpty(counts, id) {
+  return counts === null || (counts.get(id) ?? 0) > 0;
+}
+function compareNodes(left, right) {
+  return left.name.localeCompare(right.name) || compareCodeUnits(left.id, right.id);
+}
+function localizedName(row, translations, locales) {
+  return localize(row.name, translations?.get(row.id), "name", locales) ?? row.name;
+}
+function localizedDescription(row, translations, locales) {
+  return localize(row.description, translations?.get(row.id), "description", locales);
+}
+function childrenIndex(visible, eligible) {
+  const index = /* @__PURE__ */ new Map();
+  for (const row of visible.values()) {
+    if (!eligible(row)) continue;
+    const parentKey = row.parentId !== null && visible.has(row.parentId) ? row.parentId : null;
+    if (row.parentId !== null && parentKey === null) continue;
+    const bucket = index.get(parentKey) ?? [];
+    bucket.push(row);
+    index.set(parentKey, bucket);
+  }
+  return index;
+}
+function collectTreeIds(index, parentKey, levels, into) {
+  if (levels <= 0) return;
+  for (const row of index.get(parentKey) ?? []) {
+    into.push(row.id);
+    collectTreeIds(index, row.id, levels - 1, into);
+  }
+}
+async function getStorefrontCategoryTree(container, ctx, query) {
+  const runtime = resolveRuntime(container, ctx);
+  const parentKey = query.parentId ?? null;
+  const { visible, counts } = await loadCategorySnapshot(
+    runtime,
+    parentKey === null ? void 0 : (candidates) => candidates.has(parentKey)
+  );
+  if (parentKey !== null && !visible.has(parentKey)) return { tree: [], effectiveLocale: ctx.effectiveLocale };
+  const includeEmpty = query.includeEmpty === true;
+  const index = childrenIndex(visible, (row) => includeEmpty || isNonEmpty(counts, row.id));
+  const levels = query.depth ?? Number.POSITIVE_INFINITY;
+  const ids = [];
+  collectTreeIds(index, parentKey, levels, ids);
+  const translations = (await loadStorefrontTranslations(runtime.em, ctx, [{ entityType: STOREFRONT_CATEGORY_ENTITY_TYPE, ids }])).get(STOREFRONT_CATEGORY_ENTITY_TYPE);
+  const locales = localeChain(ctx);
+  const build = (parent, remaining) => {
+    if (remaining <= 0) return [];
+    return (index.get(parent) ?? []).map((row) => ({ row, name: localizedName(row, translations, locales) })).sort((left, right) => compareNodes({ name: left.name, id: left.row.id }, { name: right.name, id: right.row.id })).map(({ row, name }) => ({
+      id: row.id,
+      name,
+      slug: row.slug,
+      description: localizedDescription(row, translations, locales),
+      depth: row.depth,
+      parentId: row.parentId,
+      productCount: productCountOf(counts, row.id),
+      hasChildren: (index.get(row.id)?.length ?? 0) > 0,
+      children: build(row.id, remaining - 1)
+    }));
+  };
+  return { tree: build(parentKey, levels), effectiveLocale: ctx.effectiveLocale };
+}
+async function getStorefrontCategoryLanding(container, ctx, slug) {
+  const runtime = resolveRuntime(container, ctx);
+  const findBySlug = (candidates) => Array.from(candidates.values()).find((candidate) => candidate.slug === slug);
+  const { visible, counts } = await loadCategorySnapshot(runtime, (candidates) => findBySlug(candidates) !== void 0);
+  const row = findBySlug(visible);
+  if (!row) return null;
+  const ancestors = row.ancestorIds.flatMap((id) => {
+    const ancestor = visible.get(id);
+    return ancestor ? [ancestor] : [];
+  });
+  const children = Array.from(visible.values()).filter(
+    (candidate) => candidate.parentId === row.id && isNonEmpty(counts, candidate.id)
+  );
+  const translations = (await loadStorefrontTranslations(runtime.em, ctx, [
+    {
+      entityType: STOREFRONT_CATEGORY_ENTITY_TYPE,
+      ids: [row.id, ...ancestors.map((ancestor) => ancestor.id), ...children.map((child) => child.id)]
+    }
+  ])).get(STOREFRONT_CATEGORY_ENTITY_TYPE);
+  const locales = localeChain(ctx);
+  return {
+    category: {
+      id: row.id,
+      name: localizedName(row, translations, locales),
+      slug: row.slug,
+      description: localizedDescription(row, translations, locales),
+      depth: row.depth,
+      parentId: row.parentId,
+      ancestorIds: ancestors.map((ancestor) => ancestor.id),
+      breadcrumb: [...ancestors, row].map((entry) => ({
+        id: entry.id,
+        name: localizedName(entry, translations, locales),
+        slug: entry.slug
+      })),
+      children: children.map((child) => ({
+        id: child.id,
+        name: localizedName(child, translations, locales),
+        slug: child.slug,
+        productCount: productCountOf(counts, child.id)
+      })).sort(compareNodes),
+      productCount: productCountOf(counts, row.id),
+      seo: { title: null, description: null, canonicalUrl: null }
+    },
+    effectiveLocale: ctx.effectiveLocale
+  };
+}
+export {
+  countProductsPerCategory,
+  getStorefrontCategoryLanding,
+  getStorefrontCategoryTree,
+  loadStorefrontVisibleCategories
+};
+//# sourceMappingURL=storefrontCategories.js.map

package/dist/modules/ecommerce/lib/storefrontCategories.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ecommerce/lib/storefrontCategories.ts"],
+  "sourcesContent": ["import type { AwilixContainer } from 'awilix'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { sql } from 'kysely'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport { CatalogProductCategory } from '@open-mercato/core/modules/catalog/data/entities'\nimport { compareCodeUnits } from '@open-mercato/core/modules/catalog/lib/productScopeKeys'\nimport type { EcommerceStorefrontCategoryTreeQuery } from '../data/validators'\nimport {\n  STOREFRONT_CATEGORY_ENTITY_TYPE,\n  isCategoryInAssortment,\n  loadStorefrontTranslations,\n  localeChain,\n  localize,\n  stringList,\n  tryResolve,\n  type TranslationMap,\n} from './storefrontCatalogSupport'\nimport { queryStorefrontProductUniverse, type StorefrontFacetRuntime } from './storefrontFacets'\nimport { buildStorefrontProductScope } from './storefrontProductScope'\nimport type { StoreContext } from './types'\n\n/**\n * Category tree and category landing (Storefront Public API rev 4 \u00A74.3, \u00A74.4).\n *\n * A category is visible to a buyer when it is active, every ancestor is active (so the tree can\n * reach it) and `isCategoryInAssortment` admits it. Counts are descendant-inclusive and taken over\n * the buyer's assortment universe (`buildStorefrontProductScope`: tenant, organization, active,\n * not deleted, inside the effective scope), so a restricted buyer never sees a count for products\n * they cannot browse. Nothing here depends on prices, so the results are keyed on\n * `assortmentScopeHash` by `storefrontCategoryCache.ts`.\n *\n * Query shape, uncached: categories, the scoped product ids, the category assignments of those\n * products, and one multi-entity translation query \u2014 four, regardless of tree size. A buyer whose\n * assortment is deny-all (`[]`, e.g. a closed `require_authentication` channel) costs none.\n *\n * The product universe is capped at `STOREFRONT_FACET_UNIVERSE_CAP`: an assortment larger than\n * that is not counted, every `productCount` is `null` and no category is dropped as empty.\n */\n\nexport type StorefrontCategoryNode = {\n  id: string\n  name: string\n  slug: string | null\n  description: string | null\n  depth: number\n  parentId: string | null\n  productCount: number | null\n  hasChildren: boolean\n  children: StorefrontCategoryNode[]\n}\n\nexport type StorefrontCategoryTreeResponse = {\n  tree: StorefrontCategoryNode[]\n  effectiveLocale: string\n}\n\nexport type StorefrontCategoryBreadcrumbEntry = { id: string; name: string; slug: string | null }\n\nexport type StorefrontCategoryChild = { id: string; name: string; slug: string | null; productCount: number | null }\n\nexport type StorefrontCategorySeo = { title: string | null; description: string | null; canonicalUrl: string | null }\n\nexport type StorefrontCategoryLanding = {\n  id: string\n  name: string\n  slug: string | null\n  description: string | null\n  depth: number\n  parentId: string | null\n  ancestorIds: string[]\n  breadcrumb: StorefrontCategoryBreadcrumbEntry[]\n  children: StorefrontCategoryChild[]\n  productCount: number | null\n  seo: StorefrontCategorySeo\n}\n\nexport type StorefrontCategoryLandingBlock = {\n  category: StorefrontCategoryLanding\n  effectiveLocale: string\n}\n\ntype CategoryRow = {\n  id: string\n  name: string\n  slug: string | null\n  description: string | null\n  depth: number\n  parentId: string | null\n  isActive: boolean\n  ancestorIds: string[]\n  descendantIds: string[]\n}\n\ntype CategorySnapshot = {\n  visible: Map<string, CategoryRow>\n  /** `null` when the assortment exceeds the universe cap and was not counted. */\n  counts: Map<string, number> | null\n}\n\ntype CategoryAssignmentDatabase = {\n  catalog_product_category_assignments: {\n    product_id: string\n    category_id: string\n    tenant_id: string\n    organization_id: string\n  }\n}\n\nconst EMPTY_SNAPSHOT: CategorySnapshot = { visible: new Map(), counts: new Map() }\n\nfunction resolveRuntime(container: AwilixContainer, ctx: StoreContext): StorefrontFacetRuntime {\n  const em = tryResolve<EntityManager>(container, 'em')\n  const queryEngine = tryResolve<QueryEngine>(container, 'queryEngine')\n  if (!em || !queryEngine) throw new Error('[internal] ecommerce storefront categories require em and queryEngine')\n  return {\n    ctx,\n    em,\n    queryEngine,\n    scope: buildStorefrontProductScope(ctx),\n    decryptionScope: { tenantId: ctx.tenantId, organizationId: ctx.organizationId },\n  }\n}\n\nfunction isDenyAll(ctx: StoreContext): boolean {\n  const scope = ctx.buyer.assortmentScope\n  return scope !== null && scope.length === 0\n}\n\ntype CategoryLoadRuntime = Pick<StorefrontFacetRuntime, 'ctx' | 'em' | 'decryptionScope'>\n\nexport type StorefrontVisibleCategory = CategoryRow\n\nasync function loadCategoryRows(runtime: CategoryLoadRuntime): Promise<Map<string, CategoryRow>> {\n  const { ctx } = runtime\n  const rows = await findWithDecryption(\n    runtime.em,\n    CatalogProductCategory,\n    { tenantId: ctx.tenantId, organizationId: ctx.organizationId, deletedAt: null },\n    { fields: ['id', 'name', 'slug', 'description', 'depth', 'parentId', 'isActive', 'ancestorIds', 'descendantIds'] },\n    runtime.decryptionScope,\n  )\n  return new Map(\n    rows.map((row) => [\n      row.id,\n      {\n        id: row.id,\n        name: row.name,\n        slug: row.slug ?? null,\n        description: row.description ?? null,\n        depth: typeof row.depth === 'number' ? row.depth : 0,\n        parentId: row.parentId ?? null,\n        isActive: row.isActive !== false,\n        ancestorIds: stringList(row.ancestorIds),\n        descendantIds: stringList(row.descendantIds),\n      },\n    ]),\n  )\n}\n\nfunction selectVisibleCategories(rows: Map<string, CategoryRow>, ctx: StoreContext): Map<string, CategoryRow> {\n  const visible = new Map<string, CategoryRow>()\n  for (const row of rows.values()) {\n    if (!row.isActive) continue\n    if (!row.ancestorIds.every((id) => rows.get(id)?.isActive === true)) continue\n    const lineage = { id: row.id, ancestorIds: row.ancestorIds, descendantIds: row.descendantIds }\n    if (!isCategoryInAssortment(lineage, ctx.buyer.assortmentScope)) continue\n    visible.set(row.id, row)\n  }\n  return visible\n}\n\n/** The tenant's categories visible to the buyer (see the module header): one categories query. */\nexport async function loadStorefrontVisibleCategories(runtime: CategoryLoadRuntime): Promise<Map<string, StorefrontVisibleCategory>> {\n  return selectVisibleCategories(await loadCategoryRows(runtime), runtime.ctx)\n}\n\nasync function loadAssignedCategoryIds(\n  runtime: StorefrontFacetRuntime,\n  productIds: string[],\n): Promise<Map<string, string[]>> {\n  const { tenantId, organizationId } = runtime.decryptionScope\n  const rows = await runtime.em\n    .getKysely<CategoryAssignmentDatabase>()\n    .selectFrom('catalog_product_category_assignments as ca')\n    .select(['ca.product_id as product_id', 'ca.category_id as category_id'])\n    .where(sql<boolean>`${sql.ref('ca.product_id')} = any(${productIds}::uuid[])`)\n    .where('ca.tenant_id', '=', tenantId)\n    .where('ca.organization_id', '=', organizationId)\n    .execute()\n  const byProduct = new Map<string, string[]>()\n  for (const row of rows) {\n    const bucket = byProduct.get(row.product_id) ?? []\n    bucket.push(row.category_id)\n    byProduct.set(row.product_id, bucket)\n  }\n  return byProduct\n}\n\n/**\n * Descendant-inclusive product counts: a product counts once for every category it is assigned to\n * and once for each ancestor of those, however many of its assignments share an ancestor.\n */\nexport function countProductsPerCategory(\n  assignedByProduct: Map<string, string[]>,\n  ancestorsOf: (categoryId: string) => string[] | null,\n): Map<string, number> {\n  const counts = new Map<string, number>()\n  for (const assigned of assignedByProduct.values()) {\n    const reached = new Set<string>()\n    for (const categoryId of assigned) {\n      const ancestors = ancestorsOf(categoryId)\n      if (!ancestors) continue\n      reached.add(categoryId)\n      for (const ancestorId of ancestors) reached.add(ancestorId)\n    }\n    for (const categoryId of reached) counts.set(categoryId, (counts.get(categoryId) ?? 0) + 1)\n  }\n  return counts\n}\n\nasync function loadCategoryCounts(\n  runtime: StorefrontFacetRuntime,\n  rows: Map<string, CategoryRow>,\n  universe: Array<{ id?: unknown }> | null,\n): Promise<Map<string, number> | null> {\n  if (universe === null) return null\n  const productIds = Array.from(\n    new Set(universe.flatMap((record) => (typeof record.id === 'string' ? [record.id] : []))),\n  )\n  if (productIds.length === 0) return new Map()\n  const assigned = await loadAssignedCategoryIds(runtime, productIds)\n  return countProductsPerCategory(assigned, (categoryId) => rows.get(categoryId)?.ancestorIds ?? null)\n}\n\n/**\n * With `targetVisible`, the categories query runs first and the product universe is loaded only\n * when the requested category is visible, so an unknown slug or `parentId` costs one categories\n * query instead of three catalogue-sized ones.\n */\nasync function loadCategorySnapshot(\n  runtime: StorefrontFacetRuntime,\n  targetVisible?: (visible: Map<string, CategoryRow>) => boolean,\n): Promise<CategorySnapshot> {\n  if (isDenyAll(runtime.ctx)) return EMPTY_SNAPSHOT\n  if (targetVisible) {\n    const rows = await loadCategoryRows(runtime)\n    const visible = selectVisibleCategories(rows, runtime.ctx)\n    if (visible.size === 0 || !targetVisible(visible)) return { visible, counts: new Map() }\n    const universe = await queryStorefrontProductUniverse(runtime, runtime.scope.filters)\n    return { visible, counts: await loadCategoryCounts(runtime, rows, universe) }\n  }\n  const [rows, universe] = await Promise.all([\n    loadCategoryRows(runtime),\n    queryStorefrontProductUniverse(runtime, runtime.scope.filters),\n  ])\n  const visible = selectVisibleCategories(rows, runtime.ctx)\n  if (visible.size === 0) return { visible, counts: new Map() }\n  return { visible, counts: await loadCategoryCounts(runtime, rows, universe) }\n}\n\nfunction productCountOf(counts: Map<string, number> | null, id: string): number | null {\n  return counts === null ? null : counts.get(id) ?? 0\n}\n\nfunction isNonEmpty(counts: Map<string, number> | null, id: string): boolean {\n  return counts === null || (counts.get(id) ?? 0) > 0\n}\n\nfunction compareNodes(left: { name: string; id: string }, right: { name: string; id: string }): number {\n  return left.name.localeCompare(right.name) || compareCodeUnits(left.id, right.id)\n}\n\nfunction localizedName(row: CategoryRow, translations: TranslationMap | undefined, locales: string[]): string {\n  return localize(row.name, translations?.get(row.id), 'name', locales) ?? row.name\n}\n\nfunction localizedDescription(row: CategoryRow, translations: TranslationMap | undefined, locales: string[]): string | null {\n  return localize(row.description, translations?.get(row.id), 'description', locales)\n}\n\nfunction childrenIndex(\n  visible: Map<string, CategoryRow>,\n  eligible: (row: CategoryRow) => boolean,\n): Map<string | null, CategoryRow[]> {\n  const index = new Map<string | null, CategoryRow[]>()\n  for (const row of visible.values()) {\n    if (!eligible(row)) continue\n    const parentKey = row.parentId !== null && visible.has(row.parentId) ? row.parentId : null\n    if (row.parentId !== null && parentKey === null) continue\n    const bucket = index.get(parentKey) ?? []\n    bucket.push(row)\n    index.set(parentKey, bucket)\n  }\n  return index\n}\n\nfunction collectTreeIds(\n  index: Map<string | null, CategoryRow[]>,\n  parentKey: string | null,\n  levels: number,\n  into: string[],\n): void {\n  if (levels <= 0) return\n  for (const row of index.get(parentKey) ?? []) {\n    into.push(row.id)\n    collectTreeIds(index, row.id, levels - 1, into)\n  }\n}\n\n/**\n * `GET /categories`: the visible tree below `parentId` (the roots when omitted), `depth` levels\n * deep (all levels when omitted). Empty categories are dropped unless `includeEmpty`; a node\n * beyond `depth` is not expanded but still reports `hasChildren`. An unknown, hidden or\n * out-of-assortment `parentId` yields an empty tree, exactly like a nonexistent one.\n */\nexport async function getStorefrontCategoryTree(\n  container: AwilixContainer,\n  ctx: StoreContext,\n  query: Pick<EcommerceStorefrontCategoryTreeQuery, 'parentId' | 'depth' | 'includeEmpty'>,\n): Promise<StorefrontCategoryTreeResponse> {\n  const runtime = resolveRuntime(container, ctx)\n  const parentKey = query.parentId ?? null\n  const { visible, counts } = await loadCategorySnapshot(\n    runtime,\n    parentKey === null ? undefined : (candidates) => candidates.has(parentKey),\n  )\n  if (parentKey !== null && !visible.has(parentKey)) return { tree: [], effectiveLocale: ctx.effectiveLocale }\n  const includeEmpty = query.includeEmpty === true\n  const index = childrenIndex(visible, (row) => includeEmpty || isNonEmpty(counts, row.id))\n  const levels = query.depth ?? Number.POSITIVE_INFINITY\n  const ids: string[] = []\n  collectTreeIds(index, parentKey, levels, ids)\n  const translations = (\n    await loadStorefrontTranslations(runtime.em, ctx, [{ entityType: STOREFRONT_CATEGORY_ENTITY_TYPE, ids }])\n  ).get(STOREFRONT_CATEGORY_ENTITY_TYPE)\n  const locales = localeChain(ctx)\n\n  const build = (parent: string | null, remaining: number): StorefrontCategoryNode[] => {\n    if (remaining <= 0) return []\n    return (index.get(parent) ?? [])\n      .map((row) => ({ row, name: localizedName(row, translations, locales) }))\n      .sort((left, right) => compareNodes({ name: left.name, id: left.row.id }, { name: right.name, id: right.row.id }))\n      .map(({ row, name }) => ({\n        id: row.id,\n        name,\n        slug: row.slug,\n        description: localizedDescription(row, translations, locales),\n        depth: row.depth,\n        parentId: row.parentId,\n        productCount: productCountOf(counts, row.id),\n        hasChildren: (index.get(row.id)?.length ?? 0) > 0,\n        children: build(row.id, remaining - 1),\n      }))\n  }\n  return { tree: build(parentKey, levels), effectiveLocale: ctx.effectiveLocale }\n}\n\n/**\n * The category block of `GET /categories/:slug`. `null` for a slug that matches no visible\n * category \u2014 nonexistent, inactive, deleted, another tenant's, outside the buyer's assortment, or\n * under an inactive ancestor \u2014 all through the same single categories query, so the three cases\n * cannot be told apart by cost or by answer.\n */\nexport async function getStorefrontCategoryLanding(\n  container: AwilixContainer,\n  ctx: StoreContext,\n  slug: string,\n): Promise<StorefrontCategoryLandingBlock | null> {\n  const runtime = resolveRuntime(container, ctx)\n  const findBySlug = (candidates: Map<string, CategoryRow>) =>\n    Array.from(candidates.values()).find((candidate) => candidate.slug === slug)\n  const { visible, counts } = await loadCategorySnapshot(runtime, (candidates) => findBySlug(candidates) !== undefined)\n  const row = findBySlug(visible)\n  if (!row) return null\n  const ancestors = row.ancestorIds.flatMap((id) => {\n    const ancestor = visible.get(id)\n    return ancestor ? [ancestor] : []\n  })\n  const children = Array.from(visible.values()).filter(\n    (candidate) => candidate.parentId === row.id && isNonEmpty(counts, candidate.id),\n  )\n  const translations = (\n    await loadStorefrontTranslations(runtime.em, ctx, [\n      {\n        entityType: STOREFRONT_CATEGORY_ENTITY_TYPE,\n        ids: [row.id, ...ancestors.map((ancestor) => ancestor.id), ...children.map((child) => child.id)],\n      },\n    ])\n  ).get(STOREFRONT_CATEGORY_ENTITY_TYPE)\n  const locales = localeChain(ctx)\n  return {\n    category: {\n      id: row.id,\n      name: localizedName(row, translations, locales),\n      slug: row.slug,\n      description: localizedDescription(row, translations, locales),\n      depth: row.depth,\n      parentId: row.parentId,\n      ancestorIds: ancestors.map((ancestor) => ancestor.id),\n      breadcrumb: [...ancestors, row].map((entry) => ({\n        id: entry.id,\n        name: localizedName(entry, translations, locales),\n        slug: entry.slug,\n      })),\n      children: children\n        .map((child) => ({\n          id: child.id,\n          name: localizedName(child, translations, locales),\n          slug: child.slug,\n          productCount: productCountOf(counts, child.id),\n        }))\n        .sort(compareNodes),\n      productCount: productCountOf(counts, row.id),\n      seo: { title: null, description: null, canonicalUrl: null },\n    },\n    effectiveLocale: ctx.effectiveLocale,\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["rows", "visible", "universe"]
+}