@open-mercato/core 0.9.1-develop.7474.1.51db10479d → 0.9.1-develop.7475.1.28ca93ed97

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

@@ -0,0 +1,112 @@
+import { parseBooleanToken } from "@open-mercato/shared/lib/boolean";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { PRODUCT_SCOPE_KEYS_DOC_KEY } from "@open-mercato/core/modules/catalog/lib/productScopeKeys";
+import { E } from "../../../generated/entities.ids.generated.js";
+import { ecommerceAssortmentScopeSchema } from "../data/validators.js";
+import { resolveAnonymousAssortmentScope } from "./buyerContext.js";
+import { buildStorefrontProductScope, composeStorefrontProductFilters } from "./storefrontProductScope.js";
+const logger = createLogger("ecommerce").child({ component: "assortment-count" });
+const DRAFT_SCOPE_PARAM = "draftScope";
+const DRAFT_REQUIRE_AUTHENTICATION_PARAM = "draftRequireAuthentication";
+function readSingleParam(searchParams, name) {
+  const values = searchParams.getAll(name);
+  if (values.length === 0) return null;
+  if (values.length > 1) return "duplicate";
+  return values[0];
+}
+function parseAssortmentCountDraft(searchParams, translate) {
+  const fieldErrors = {};
+  const draft = {};
+  const rawScope = readSingleParam(searchParams, DRAFT_SCOPE_PARAM);
+  if (rawScope !== null) {
+    const invalidJson = translate(
+      "ecommerce.validation.draftScopeJsonInvalid",
+      "The draft scope must be a JSON-encoded assortment scope."
+    );
+    if (rawScope === "duplicate") {
+      fieldErrors[DRAFT_SCOPE_PARAM] = invalidJson;
+    } else {
+      let decoded;
+      let decodable = true;
+      try {
+        decoded = JSON.parse(rawScope);
+      } catch {
+        decodable = false;
+        fieldErrors[DRAFT_SCOPE_PARAM] = invalidJson;
+      }
+      if (decodable) {
+        const parsed = ecommerceAssortmentScopeSchema.safeParse(decoded);
+        if (parsed.success) {
+          draft.scope = parsed.data;
+        } else {
+          fieldErrors[DRAFT_SCOPE_PARAM] = translate(
+            "ecommerce.validation.draftScopeInvalid",
+            "The draft scope may only contain category, tag and excluded product, category and tag ids."
+          );
+        }
+      }
+    }
+  }
+  const rawRequireAuthentication = readSingleParam(searchParams, DRAFT_REQUIRE_AUTHENTICATION_PARAM);
+  if (rawRequireAuthentication !== null) {
+    const parsed = rawRequireAuthentication === "duplicate" ? null : parseBooleanToken(rawRequireAuthentication);
+    if (parsed === null) {
+      fieldErrors[DRAFT_REQUIRE_AUTHENTICATION_PARAM] = translate(
+        "ecommerce.validation.draftRequireAuthenticationInvalid",
+        "The draft require-authentication value must be true or false."
+      );
+    } else {
+      draft.requireAuthentication = parsed;
+    }
+  }
+  if (Object.keys(fieldErrors).length > 0) return { ok: false, fieldErrors };
+  return { ok: true, draft };
+}
+async function countStorefrontProducts(queryEngine, scope, assortmentScope, extra) {
+  if (Array.isArray(assortmentScope) && assortmentScope.length === 0) return 0;
+  const productScope = buildStorefrontProductScope({ ...scope, buyer: { assortmentScope } });
+  const result = await queryEngine.query(E.catalog.catalog_product, {
+    tenantId: productScope.tenantId,
+    organizationId: productScope.organizationId,
+    withDeleted: productScope.withDeleted,
+    filters: composeStorefrontProductFilters(productScope, extra),
+    fields: ["id"],
+    page: { page: 1, pageSize: 1 }
+  });
+  return result.total;
+}
+async function countChannelAssortment(container, input) {
+  const queryEngine = container.resolve("queryEngine");
+  const scope = { tenantId: input.tenantId, organizationId: input.organizationId };
+  const openScope = await resolveAnonymousAssortmentScope(container, {
+    tenantId: input.tenantId,
+    channelAssortmentScope: input.channelAssortmentScope,
+    requireAuthentication: false
+  });
+  const countWithoutAuthentication = await countStorefrontProducts(queryEngine, scope, openScope);
+  const count = input.requireAuthentication ? 0 : countWithoutAuthentication;
+  const restricted = openScope !== null && openScope.length > 0;
+  const unindexedCount = restricted ? await countStorefrontProducts(queryEngine, scope, null, { [PRODUCT_SCOPE_KEYS_DOC_KEY]: { $exists: false } }) : 0;
+  if (unindexedCount > 0) {
+    logger.info("Active products without a scope index fail closed under a restricted assortment scope", {
+      organizationId: input.organizationId,
+      scopeSource: input.scopeSource,
+      unindexedCount
+    });
+  }
+  return {
+    count,
+    scopeSource: input.scopeSource,
+    requireAuthentication: input.requireAuthentication,
+    reducedByAuthentication: input.requireAuthentication && countWithoutAuthentication > 0,
+    countWithoutAuthentication,
+    unindexedCount
+  };
+}
+export {
+  DRAFT_REQUIRE_AUTHENTICATION_PARAM,
+  DRAFT_SCOPE_PARAM,
+  countChannelAssortment,
+  parseAssortmentCountDraft
+};
+//# sourceMappingURL=assortmentCount.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ecommerce/lib/assortmentCount.ts"],
+  "sourcesContent": ["import type { AwilixContainer } from 'awilix'\nimport type { AssortmentScope, EffectiveAssortmentScope } from '@open-mercato/shared/lib/catalog-visibility'\nimport { parseBooleanToken } from '@open-mercato/shared/lib/boolean'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport type { QueryEngine, Where } from '@open-mercato/shared/lib/query/types'\nimport { PRODUCT_SCOPE_KEYS_DOC_KEY } from '@open-mercato/core/modules/catalog/lib/productScopeKeys'\nimport { E } from '#generated/entities.ids.generated'\nimport { ecommerceAssortmentScopeSchema } from '../data/validators'\nimport { resolveAnonymousAssortmentScope } from './buyerContext'\nimport type { Translate } from './crudSupport'\nimport { buildStorefrontProductScope, composeStorefrontProductFilters } from './storefrontProductScope'\n\nconst logger = createLogger('ecommerce').child({ component: 'assortment-count' })\n\nexport type AssortmentCountScopeSource = 'saved' | 'draft'\n\nexport type AssortmentCountResponse = {\n  count: number\n  scopeSource: AssortmentCountScopeSource\n  requireAuthentication: boolean\n  reducedByAuthentication: boolean\n  countWithoutAuthentication: number\n  unindexedCount: number\n}\n\nexport type AssortmentCountDraft = {\n  scope?: AssortmentScope | null\n  requireAuthentication?: boolean\n}\n\nexport type AssortmentCountDraftResult =\n  | { ok: true; draft: AssortmentCountDraft }\n  | { ok: false; fieldErrors: Record<string, string> }\n\nexport const DRAFT_SCOPE_PARAM = 'draftScope'\nexport const DRAFT_REQUIRE_AUTHENTICATION_PARAM = 'draftRequireAuthentication'\n\nfunction readSingleParam(searchParams: URLSearchParams, name: string): string | null | 'duplicate' {\n  const values = searchParams.getAll(name)\n  if (values.length === 0) return null\n  if (values.length > 1) return 'duplicate'\n  return values[0]\n}\n\n/**\n * Parses the unsaved Channels-tab state a count request may carry. `draftScope` is a JSON-encoded\n * `assortment_scope` validated with the schema the channel binding write path uses, so `allOf` and\n * any unknown key are rejected exactly as they are on save; `draftRequireAuthentication` is a\n * boolean token. Absent parameters fall back to the saved binding.\n */\nexport function parseAssortmentCountDraft(searchParams: URLSearchParams, translate: Translate): AssortmentCountDraftResult {\n  const fieldErrors: Record<string, string> = {}\n  const draft: AssortmentCountDraft = {}\n\n  const rawScope = readSingleParam(searchParams, DRAFT_SCOPE_PARAM)\n  if (rawScope !== null) {\n    const invalidJson = translate(\n      'ecommerce.validation.draftScopeJsonInvalid',\n      'The draft scope must be a JSON-encoded assortment scope.',\n    )\n    if (rawScope === 'duplicate') {\n      fieldErrors[DRAFT_SCOPE_PARAM] = invalidJson\n    } else {\n      let decoded: unknown\n      let decodable = true\n      try {\n        decoded = JSON.parse(rawScope)\n      } catch {\n        decodable = false\n        fieldErrors[DRAFT_SCOPE_PARAM] = invalidJson\n      }\n      if (decodable) {\n        const parsed = ecommerceAssortmentScopeSchema.safeParse(decoded)\n        if (parsed.success) {\n          draft.scope = parsed.data\n        } else {\n          fieldErrors[DRAFT_SCOPE_PARAM] = translate(\n            'ecommerce.validation.draftScopeInvalid',\n            'The draft scope may only contain category, tag and excluded product, category and tag ids.',\n          )\n        }\n      }\n    }\n  }\n\n  const rawRequireAuthentication = readSingleParam(searchParams, DRAFT_REQUIRE_AUTHENTICATION_PARAM)\n  if (rawRequireAuthentication !== null) {\n    const parsed = rawRequireAuthentication === 'duplicate' ? null : parseBooleanToken(rawRequireAuthentication)\n    if (parsed === null) {\n      fieldErrors[DRAFT_REQUIRE_AUTHENTICATION_PARAM] = translate(\n        'ecommerce.validation.draftRequireAuthenticationInvalid',\n        'The draft require-authentication value must be true or false.',\n      )\n    } else {\n      draft.requireAuthentication = parsed\n    }\n  }\n\n  if (Object.keys(fieldErrors).length > 0) return { ok: false, fieldErrors }\n  return { ok: true, draft }\n}\n\ntype CountScope = { tenantId: string; organizationId: string }\n\nasync function countStorefrontProducts(\n  queryEngine: QueryEngine,\n  scope: CountScope,\n  assortmentScope: EffectiveAssortmentScope,\n  extra?: Where,\n): Promise<number> {\n  if (Array.isArray(assortmentScope) && assortmentScope.length === 0) return 0\n  const productScope = buildStorefrontProductScope({ ...scope, buyer: { assortmentScope } })\n  const result = await queryEngine.query(E.catalog.catalog_product, {\n    tenantId: productScope.tenantId,\n    organizationId: productScope.organizationId,\n    withDeleted: productScope.withDeleted,\n    filters: composeStorefrontProductFilters(productScope, extra),\n    fields: ['id'],\n    page: { page: 1, pageSize: 1 },\n  })\n  return result.total\n}\n\n/**\n * Live product count behind the Channels tab (SPEC-029 \u00A79.2, \u00A710a US-E1): how many products the\n * channel would show an anonymous buyer. The effective assortment comes from the storefront's own\n * buyer resolution (`resolveAnonymousAssortmentScope`) and is counted through the same\n * `buildStorefrontProductScope` + `composeStorefrontProductFilters` query the listing composes, so\n * the admin number cannot drift from the storefront's total.\n *\n * `count` is the anonymous figure \u2014 `0` while `requireAuthentication` is on \u2014 and\n * `countWithoutAuthentication` is what the same scope would show with the gate off, so the form can\n * say how many products the toggle hides. `unindexedCount` reports active products with no\n * `scope_keys` document yet: they fail closed under any restricted scope, so a non-zero value\n * explains a count that looks too low.\n */\nexport async function countChannelAssortment(\n  container: AwilixContainer,\n  input: {\n    tenantId: string\n    organizationId: string\n    channelAssortmentScope: AssortmentScope | null\n    requireAuthentication: boolean\n    scopeSource: AssortmentCountScopeSource\n  },\n): Promise<AssortmentCountResponse> {\n  const queryEngine = container.resolve('queryEngine') as QueryEngine\n  const scope: CountScope = { tenantId: input.tenantId, organizationId: input.organizationId }\n  const openScope = await resolveAnonymousAssortmentScope(container, {\n    tenantId: input.tenantId,\n    channelAssortmentScope: input.channelAssortmentScope,\n    requireAuthentication: false,\n  })\n  const countWithoutAuthentication = await countStorefrontProducts(queryEngine, scope, openScope)\n  const count = input.requireAuthentication ? 0 : countWithoutAuthentication\n  const restricted = openScope !== null && openScope.length > 0\n  const unindexedCount = restricted\n    ? await countStorefrontProducts(queryEngine, scope, null, { [PRODUCT_SCOPE_KEYS_DOC_KEY]: { $exists: false } })\n    : 0\n  if (unindexedCount > 0) {\n    logger.info('Active products without a scope index fail closed under a restricted assortment scope', {\n      organizationId: input.organizationId,\n      scopeSource: input.scopeSource,\n      unindexedCount,\n    })\n  }\n  return {\n    count,\n    scopeSource: input.scopeSource,\n    requireAuthentication: input.requireAuthentication,\n    reducedByAuthentication: input.requireAuthentication && countWithoutAuthentication > 0,\n    countWithoutAuthentication,\n    unindexedCount,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,184 @@
+const ECOMMERCE_BRANDING_FONTS = [
+  {
+    id: "system-sans",
+    label: "System sans-serif",
+    stack: "system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
+    googleFamily: null
+  },
+  { id: "system-serif", label: "System serif", stack: "Georgia, 'Times New Roman', Times, serif", googleFamily: null },
+  {
+    id: "system-mono",
+    label: "System monospace",
+    stack: "ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace",
+    googleFamily: null
+  },
+  { id: "inter", label: "Inter", stack: "'Inter', sans-serif", googleFamily: "Inter" },
+  { id: "roboto", label: "Roboto", stack: "'Roboto', sans-serif", googleFamily: "Roboto" },
+  { id: "open-sans", label: "Open Sans", stack: "'Open Sans', sans-serif", googleFamily: "Open Sans" },
+  { id: "lato", label: "Lato", stack: "'Lato', sans-serif", googleFamily: "Lato" },
+  { id: "montserrat", label: "Montserrat", stack: "'Montserrat', sans-serif", googleFamily: "Montserrat" },
+  { id: "poppins", label: "Poppins", stack: "'Poppins', sans-serif", googleFamily: "Poppins" },
+  { id: "dm-sans", label: "DM Sans", stack: "'DM Sans', sans-serif", googleFamily: "DM Sans" },
+  { id: "merriweather", label: "Merriweather", stack: "'Merriweather', serif", googleFamily: "Merriweather" },
+  {
+    id: "playfair-display",
+    label: "Playfair Display",
+    stack: "'Playfair Display', serif",
+    googleFamily: "Playfair Display"
+  }
+];
+const ecommerceBrandingFontIds = ECOMMERCE_BRANDING_FONTS.map((font) => font.id);
+function findEcommerceBrandingFont(id) {
+  return ECOMMERCE_BRANDING_FONTS.find((font) => font.id === id) ?? null;
+}
+const NUMBER_PATTERN = "(\\d+(?:\\.\\d+)?|\\.\\d+)";
+const OKLCH_PATTERN = new RegExp(
+  `^oklch\\(\\s*${NUMBER_PATTERN}(%?)\\s+${NUMBER_PATTERN}(%?)\\s+${NUMBER_PATTERN}(deg)?\\s*(?:\\/\\s*${NUMBER_PATTERN}(%?)\\s*)?\\)$`
+);
+const HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const BORDER_RADIUS_PATTERN = /^(\d+(?:\.\d+)?|\.\d+)(rem|px)$/;
+const OKLCH_CHROMA_MAX = 0.5;
+const OKLCH_HUE_MAX = 360;
+const BORDER_RADIUS_REM_MAX = 5;
+const BORDER_RADIUS_PX_MAX = 80;
+function withinBounds(raw, percent, numericMax) {
+  const value = Number(raw);
+  if (!Number.isFinite(value) || value < 0) return false;
+  return percent ? value <= 100 : value <= numericMax;
+}
+function isValidOklchColor(value) {
+  return normalizeOklchColor(value) !== null;
+}
+function normalizeOklchColor(value) {
+  const match = OKLCH_PATTERN.exec(value);
+  if (!match) return null;
+  const [, lightness, lightnessPercent, chroma, chromaPercent, hue, hueUnit, alpha, alphaPercent] = match;
+  if (!withinBounds(lightness, lightnessPercent === "%", 1)) return null;
+  if (!withinBounds(chroma, chromaPercent === "%", OKLCH_CHROMA_MAX)) return null;
+  if (!withinBounds(hue, false, OKLCH_HUE_MAX)) return null;
+  if (alpha !== void 0 && !withinBounds(alpha, alphaPercent === "%", 1)) return null;
+  const alphaPart = alpha === void 0 ? "" : ` / ${alpha}${alphaPercent}`;
+  return `oklch(${lightness}${lightnessPercent} ${chroma}${chromaPercent} ${hue}${hueUnit ?? ""}${alphaPart})`;
+}
+function isValidBrandingColor(value) {
+  return HEX_COLOR_PATTERN.test(value) || isValidOklchColor(value);
+}
+function normalizeBrandingColor(value) {
+  if (HEX_COLOR_PATTERN.test(value)) return value.toLowerCase();
+  return normalizeOklchColor(value);
+}
+function isValidBorderRadius(value) {
+  if (value === "0") return true;
+  const match = BORDER_RADIUS_PATTERN.exec(value);
+  if (!match) return false;
+  const amount = Number(match[1]);
+  if (!Number.isFinite(amount)) return false;
+  return match[2] === "rem" ? amount <= BORDER_RADIUS_REM_MAX : amount <= BORDER_RADIUS_PX_MAX;
+}
+const ECOMMERCE_BRANDING_COLOR_KEYS = [
+  "primaryColor",
+  "primaryForeground",
+  "accentColor",
+  "accentForeground",
+  "backgroundColor",
+  "foregroundColor"
+];
+const ECOMMERCE_BRANDING_FONT_KEYS = ["fontFamilyBase", "fontFamilyHeading"];
+const BRANDING_PROPERTY_BY_KEY = {
+  primaryColor: "--primary",
+  primaryForeground: "--primary-foreground",
+  accentColor: "--accent",
+  accentForeground: "--accent-foreground",
+  backgroundColor: "--background",
+  foregroundColor: "--foreground",
+  borderRadius: "--radius",
+  fontFamilyBase: "--font-base",
+  fontFamilyHeading: "--font-heading"
+};
+const BRANDING_TOKEN_ORDER = [
+  "primaryColor",
+  "primaryForeground",
+  "accentColor",
+  "accentForeground",
+  "backgroundColor",
+  "foregroundColor",
+  "borderRadius",
+  "fontFamilyBase",
+  "fontFamilyHeading"
+];
+const ECOMMERCE_BRANDING_CSS_PROPERTIES = BRANDING_TOKEN_ORDER.map(
+  (key) => BRANDING_PROPERTY_BY_KEY[key]
+);
+const DEFAULT_FONT_BASE_ID = "inter";
+const HEADING_INHERITS_BASE = "var(--font-base)";
+const ECOMMERCE_BRANDING_DEFAULTS = {
+  primaryColor: "oklch(0.205 0 0)",
+  primaryForeground: "oklch(0.985 0 0)",
+  accentColor: "oklch(0.97 0 0)",
+  accentForeground: "oklch(0.205 0 0)",
+  backgroundColor: "oklch(1 0 0)",
+  foregroundColor: "oklch(0.145 0 0)",
+  borderRadius: "0.625rem"
+};
+const NONCE_PATTERN = /^[A-Za-z0-9+/_-]{8,128}={0,2}$/;
+function readOwnString(source, key) {
+  if (typeof source !== "object" || source === null) return null;
+  if (!Object.prototype.hasOwnProperty.call(source, key)) return null;
+  const value = source[key];
+  return typeof value === "string" ? value : null;
+}
+function resolveColor(source, key) {
+  const raw = readOwnString(source, key);
+  return (raw === null ? null : normalizeBrandingColor(raw)) ?? ECOMMERCE_BRANDING_DEFAULTS[key];
+}
+function resolveBorderRadius(source) {
+  const raw = readOwnString(source, "borderRadius");
+  return raw !== null && isValidBorderRadius(raw) ? raw : ECOMMERCE_BRANDING_DEFAULTS.borderRadius;
+}
+function resolveFontStack(source, key) {
+  const raw = readOwnString(source, key);
+  const font = raw === null ? null : findEcommerceBrandingFont(raw);
+  return font ? font.stack : null;
+}
+function buildBrandingDeclarations(branding) {
+  const baseStack = resolveFontStack(branding, "fontFamilyBase") ?? findEcommerceBrandingFont(DEFAULT_FONT_BASE_ID)?.stack ?? "sans-serif";
+  const headingStack = resolveFontStack(branding, "fontFamilyHeading") ?? HEADING_INHERITS_BASE;
+  const values = {
+    primaryColor: resolveColor(branding, "primaryColor"),
+    primaryForeground: resolveColor(branding, "primaryForeground"),
+    accentColor: resolveColor(branding, "accentColor"),
+    accentForeground: resolveColor(branding, "accentForeground"),
+    backgroundColor: resolveColor(branding, "backgroundColor"),
+    foregroundColor: resolveColor(branding, "foregroundColor"),
+    borderRadius: resolveBorderRadius(branding),
+    fontFamilyBase: baseStack,
+    fontFamilyHeading: headingStack
+  };
+  return BRANDING_TOKEN_ORDER.map((key) => ({ property: BRANDING_PROPERTY_BY_KEY[key], value: values[key] }));
+}
+function renderBrandingRootRule(branding) {
+  const body = buildBrandingDeclarations(branding).map((declaration) => `${declaration.property}:${declaration.value}`).join(";");
+  return `:root{${body}}`;
+}
+function renderBrandingStyleBlock(branding, options = {}) {
+  const nonce = typeof options.nonce === "string" && NONCE_PATTERN.test(options.nonce) ? options.nonce : null;
+  const attributes = nonce ? ` nonce="${nonce}"` : "";
+  return `<style data-ecommerce-branding${attributes}>${renderBrandingRootRule(branding)}</style>`;
+}
+export {
+  ECOMMERCE_BRANDING_COLOR_KEYS,
+  ECOMMERCE_BRANDING_CSS_PROPERTIES,
+  ECOMMERCE_BRANDING_DEFAULTS,
+  ECOMMERCE_BRANDING_FONTS,
+  ECOMMERCE_BRANDING_FONT_KEYS,
+  buildBrandingDeclarations,
+  ecommerceBrandingFontIds,
+  findEcommerceBrandingFont,
+  isValidBorderRadius,
+  isValidBrandingColor,
+  isValidOklchColor,
+  normalizeBrandingColor,
+  renderBrandingRootRule,
+  renderBrandingStyleBlock
+};
+//# sourceMappingURL=brandingStyles.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ecommerce/lib/brandingStyles.ts"],
+  "sourcesContent": ["export type EcommerceBrandingFont = {\n  id: string\n  label: string\n  stack: string\n  googleFamily: string | null\n}\n\nexport const ECOMMERCE_BRANDING_FONTS: readonly EcommerceBrandingFont[] = [\n  {\n    id: 'system-sans',\n    label: 'System sans-serif',\n    stack: \"system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif\",\n    googleFamily: null,\n  },\n  { id: 'system-serif', label: 'System serif', stack: \"Georgia, 'Times New Roman', Times, serif\", googleFamily: null },\n  {\n    id: 'system-mono',\n    label: 'System monospace',\n    stack: \"ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace\",\n    googleFamily: null,\n  },\n  { id: 'inter', label: 'Inter', stack: \"'Inter', sans-serif\", googleFamily: 'Inter' },\n  { id: 'roboto', label: 'Roboto', stack: \"'Roboto', sans-serif\", googleFamily: 'Roboto' },\n  { id: 'open-sans', label: 'Open Sans', stack: \"'Open Sans', sans-serif\", googleFamily: 'Open Sans' },\n  { id: 'lato', label: 'Lato', stack: \"'Lato', sans-serif\", googleFamily: 'Lato' },\n  { id: 'montserrat', label: 'Montserrat', stack: \"'Montserrat', sans-serif\", googleFamily: 'Montserrat' },\n  { id: 'poppins', label: 'Poppins', stack: \"'Poppins', sans-serif\", googleFamily: 'Poppins' },\n  { id: 'dm-sans', label: 'DM Sans', stack: \"'DM Sans', sans-serif\", googleFamily: 'DM Sans' },\n  { id: 'merriweather', label: 'Merriweather', stack: \"'Merriweather', serif\", googleFamily: 'Merriweather' },\n  {\n    id: 'playfair-display',\n    label: 'Playfair Display',\n    stack: \"'Playfair Display', serif\",\n    googleFamily: 'Playfair Display',\n  },\n]\n\nexport const ecommerceBrandingFontIds: readonly string[] = ECOMMERCE_BRANDING_FONTS.map((font) => font.id)\n\nexport function findEcommerceBrandingFont(id: string): EcommerceBrandingFont | null {\n  return ECOMMERCE_BRANDING_FONTS.find((font) => font.id === id) ?? null\n}\n\nconst NUMBER_PATTERN = '(\\\\d+(?:\\\\.\\\\d+)?|\\\\.\\\\d+)'\nconst OKLCH_PATTERN = new RegExp(\n  `^oklch\\\\(\\\\s*${NUMBER_PATTERN}(%?)\\\\s+${NUMBER_PATTERN}(%?)\\\\s+${NUMBER_PATTERN}(deg)?\\\\s*(?:\\\\/\\\\s*${NUMBER_PATTERN}(%?)\\\\s*)?\\\\)$`,\n)\nconst HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/\nconst BORDER_RADIUS_PATTERN = /^(\\d+(?:\\.\\d+)?|\\.\\d+)(rem|px)$/\n\nconst OKLCH_CHROMA_MAX = 0.5\nconst OKLCH_HUE_MAX = 360\nconst BORDER_RADIUS_REM_MAX = 5\nconst BORDER_RADIUS_PX_MAX = 80\n\nfunction withinBounds(raw: string, percent: boolean, numericMax: number): boolean {\n  const value = Number(raw)\n  if (!Number.isFinite(value) || value < 0) return false\n  return percent ? value <= 100 : value <= numericMax\n}\n\nexport function isValidOklchColor(value: string): boolean {\n  return normalizeOklchColor(value) !== null\n}\n\nfunction normalizeOklchColor(value: string): string | null {\n  const match = OKLCH_PATTERN.exec(value)\n  if (!match) return null\n  const [, lightness, lightnessPercent, chroma, chromaPercent, hue, hueUnit, alpha, alphaPercent] = match\n  if (!withinBounds(lightness, lightnessPercent === '%', 1)) return null\n  if (!withinBounds(chroma, chromaPercent === '%', OKLCH_CHROMA_MAX)) return null\n  if (!withinBounds(hue, false, OKLCH_HUE_MAX)) return null\n  if (alpha !== undefined && !withinBounds(alpha, alphaPercent === '%', 1)) return null\n  const alphaPart = alpha === undefined ? '' : ` / ${alpha}${alphaPercent}`\n  return `oklch(${lightness}${lightnessPercent} ${chroma}${chromaPercent} ${hue}${hueUnit ?? ''}${alphaPart})`\n}\n\nexport function isValidBrandingColor(value: string): boolean {\n  return HEX_COLOR_PATTERN.test(value) || isValidOklchColor(value)\n}\n\nexport function normalizeBrandingColor(value: string): string | null {\n  if (HEX_COLOR_PATTERN.test(value)) return value.toLowerCase()\n  return normalizeOklchColor(value)\n}\n\nexport function isValidBorderRadius(value: string): boolean {\n  if (value === '0') return true\n  const match = BORDER_RADIUS_PATTERN.exec(value)\n  if (!match) return false\n  const amount = Number(match[1])\n  if (!Number.isFinite(amount)) return false\n  return match[2] === 'rem' ? amount <= BORDER_RADIUS_REM_MAX : amount <= BORDER_RADIUS_PX_MAX\n}\n\nexport const ECOMMERCE_BRANDING_COLOR_KEYS = [\n  'primaryColor',\n  'primaryForeground',\n  'accentColor',\n  'accentForeground',\n  'backgroundColor',\n  'foregroundColor',\n] as const\n\nexport const ECOMMERCE_BRANDING_FONT_KEYS = ['fontFamilyBase', 'fontFamilyHeading'] as const\n\nexport type EcommerceBrandingColorKey = (typeof ECOMMERCE_BRANDING_COLOR_KEYS)[number]\nexport type EcommerceBrandingFontKey = (typeof ECOMMERCE_BRANDING_FONT_KEYS)[number]\nexport type EcommerceBrandingTokenKey = EcommerceBrandingColorKey | 'borderRadius' | EcommerceBrandingFontKey\n\nexport type EcommerceBrandingDeclaration = {\n  property: string\n  value: string\n}\n\nconst BRANDING_PROPERTY_BY_KEY: Readonly<Record<EcommerceBrandingTokenKey, string>> = {\n  primaryColor: '--primary',\n  primaryForeground: '--primary-foreground',\n  accentColor: '--accent',\n  accentForeground: '--accent-foreground',\n  backgroundColor: '--background',\n  foregroundColor: '--foreground',\n  borderRadius: '--radius',\n  fontFamilyBase: '--font-base',\n  fontFamilyHeading: '--font-heading',\n}\n\nconst BRANDING_TOKEN_ORDER: readonly EcommerceBrandingTokenKey[] = [\n  'primaryColor',\n  'primaryForeground',\n  'accentColor',\n  'accentForeground',\n  'backgroundColor',\n  'foregroundColor',\n  'borderRadius',\n  'fontFamilyBase',\n  'fontFamilyHeading',\n]\n\nexport const ECOMMERCE_BRANDING_CSS_PROPERTIES: readonly string[] = BRANDING_TOKEN_ORDER.map(\n  (key) => BRANDING_PROPERTY_BY_KEY[key],\n)\n\nconst DEFAULT_FONT_BASE_ID = 'inter'\nconst HEADING_INHERITS_BASE = 'var(--font-base)'\n\nexport const ECOMMERCE_BRANDING_DEFAULTS: Readonly<Record<EcommerceBrandingColorKey | 'borderRadius', string>> = {\n  primaryColor: 'oklch(0.205 0 0)',\n  primaryForeground: 'oklch(0.985 0 0)',\n  accentColor: 'oklch(0.97 0 0)',\n  accentForeground: 'oklch(0.205 0 0)',\n  backgroundColor: 'oklch(1 0 0)',\n  foregroundColor: 'oklch(0.145 0 0)',\n  borderRadius: '0.625rem',\n}\n\nconst NONCE_PATTERN = /^[A-Za-z0-9+/_-]{8,128}={0,2}$/\n\nfunction readOwnString(source: unknown, key: string): string | null {\n  if (typeof source !== 'object' || source === null) return null\n  if (!Object.prototype.hasOwnProperty.call(source, key)) return null\n  const value = (source as Record<string, unknown>)[key]\n  return typeof value === 'string' ? value : null\n}\n\nfunction resolveColor(source: unknown, key: EcommerceBrandingColorKey): string {\n  const raw = readOwnString(source, key)\n  return (raw === null ? null : normalizeBrandingColor(raw)) ?? ECOMMERCE_BRANDING_DEFAULTS[key]\n}\n\nfunction resolveBorderRadius(source: unknown): string {\n  const raw = readOwnString(source, 'borderRadius')\n  return raw !== null && isValidBorderRadius(raw) ? raw : ECOMMERCE_BRANDING_DEFAULTS.borderRadius\n}\n\nfunction resolveFontStack(source: unknown, key: EcommerceBrandingFontKey): string | null {\n  const raw = readOwnString(source, key)\n  const font = raw === null ? null : findEcommerceBrandingFont(raw)\n  return font ? font.stack : null\n}\n\nexport function buildBrandingDeclarations(branding: unknown): EcommerceBrandingDeclaration[] {\n  const baseStack =\n    resolveFontStack(branding, 'fontFamilyBase') ?? findEcommerceBrandingFont(DEFAULT_FONT_BASE_ID)?.stack ?? 'sans-serif'\n  const headingStack = resolveFontStack(branding, 'fontFamilyHeading') ?? HEADING_INHERITS_BASE\n  const values: Record<EcommerceBrandingTokenKey, string> = {\n    primaryColor: resolveColor(branding, 'primaryColor'),\n    primaryForeground: resolveColor(branding, 'primaryForeground'),\n    accentColor: resolveColor(branding, 'accentColor'),\n    accentForeground: resolveColor(branding, 'accentForeground'),\n    backgroundColor: resolveColor(branding, 'backgroundColor'),\n    foregroundColor: resolveColor(branding, 'foregroundColor'),\n    borderRadius: resolveBorderRadius(branding),\n    fontFamilyBase: baseStack,\n    fontFamilyHeading: headingStack,\n  }\n  return BRANDING_TOKEN_ORDER.map((key) => ({ property: BRANDING_PROPERTY_BY_KEY[key], value: values[key] }))\n}\n\nexport function renderBrandingRootRule(branding: unknown): string {\n  const body = buildBrandingDeclarations(branding)\n    .map((declaration) => `${declaration.property}:${declaration.value}`)\n    .join(';')\n  return `:root{${body}}`\n}\n\nexport type BrandingStyleBlockOptions = {\n  nonce?: string | null\n}\n\nexport function renderBrandingStyleBlock(branding: unknown, options: BrandingStyleBlockOptions = {}): string {\n  const nonce = typeof options.nonce === 'string' && NONCE_PATTERN.test(options.nonce) ? options.nonce : null\n  const attributes = nonce ? ` nonce=\"${nonce}\"` : ''\n  return `<style data-ecommerce-branding${attributes}>${renderBrandingRootRule(branding)}</style>`\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,284 @@
+import { createHash } from "node:crypto";
+import {
+  hashEffectiveScope,
+  intersectScopes
+} from "@open-mercato/shared/lib/catalog-visibility";
+import { findOneWithDecryption } 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 { CustomerUser } from "@open-mercato/core/modules/customer_accounts/data/entities";
+import { CatalogPriceKind } from "@open-mercato/core/modules/catalog/data/entities";
+import { emitEcommerceEvent } from "../events.js";
+import { buyerContextCache, ecommerceResolutionCache } from "./cacheKeys.js";
+import { StorefrontResolutionError } from "./storeContext.js";
+const ASSORTMENT_EMPTY_THROTTLE_MS = 36e5;
+const DIGEST_LENGTH = 16;
+const NULL_SEGMENT = "-";
+const logger = createLogger("ecommerce").child({ component: "buyer-context" });
+const ANONYMOUS_IDENTITY = {
+  customerUserId: null,
+  customerId: null,
+  companyId: null,
+  customerIds: [],
+  isAuthenticated: false
+};
+function tryResolve(container, name) {
+  try {
+    const resolved = container.resolve(name);
+    return resolved ?? null;
+  } catch {
+    return null;
+  }
+}
+function requireService(container, name) {
+  const service = tryResolve(container, name);
+  if (!service) throw new Error(`[internal] ecommerce buyer context requires the DI service ${name}`);
+  return service;
+}
+function sha256Truncated(segments) {
+  return createHash("sha256").update(segments.join("|")).digest("hex").slice(0, DIGEST_LENGTH);
+}
+function computePriceScopeKey(input) {
+  const sortedGroupIds = [...input.customerGroupIds].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+  return sha256Truncated([
+    input.channelId,
+    input.currencyCode,
+    input.priceKindId ?? NULL_SEGMENT,
+    sortedGroupIds.join(",")
+  ]);
+}
+function computeStoreContextDigest(input) {
+  return sha256Truncated([
+    input.storeId,
+    input.effectiveLocale,
+    input.taxMode,
+    input.priceScopeKey,
+    input.assortmentScopeHash,
+    input.customerOverlayId ?? NULL_SEGMENT
+  ]);
+}
+function buyerIdentityFromCustomerUser(user) {
+  const personId = user.personEntityId ?? null;
+  const companyId = user.customerEntityId ?? null;
+  const customerIds = Array.from(
+    new Set([personId, companyId].filter((id) => typeof id === "string" && id.length > 0))
+  );
+  return {
+    customerUserId: user.id,
+    customerId: personId ?? companyId,
+    companyId,
+    customerIds,
+    isAuthenticated: true
+  };
+}
+async function loadBuyerIdentity(em, customerUserId, store) {
+  const scope = { tenantId: store.tenantId, organizationId: store.organizationId };
+  const user = await findOneWithDecryption(
+    em,
+    CustomerUser,
+    { id: customerUserId, ...scope, isActive: true, deletedAt: null },
+    void 0,
+    scope
+  );
+  if (!user) {
+    logger.debug("Portal session points at a missing or inactive customer user", { storeId: store.store.id });
+    throw new StorefrontResolutionError(401, "portal_session_invalid");
+  }
+  return buyerIdentityFromCustomerUser(user);
+}
+function taxModeFromPriceKindDisplayMode(displayMode) {
+  if (displayMode === "excluding-tax") return "net";
+  if (displayMode === "including-tax") return "gross";
+  return null;
+}
+async function resolveTaxMode(em, priceKindId, store) {
+  const fallback = store.store.settings.display.priceDisplayModeDefault;
+  if (!priceKindId) return fallback;
+  const scope = { tenantId: store.tenantId, organizationId: store.organizationId };
+  const priceKind = await findOneWithDecryption(
+    em,
+    CatalogPriceKind,
+    {
+      id: priceKindId,
+      tenantId: store.tenantId,
+      deletedAt: null,
+      $or: [{ organizationId: null }, { organizationId: store.organizationId }]
+    },
+    void 0,
+    scope
+  );
+  return taxModeFromPriceKindDisplayMode(priceKind?.displayMode) ?? fallback;
+}
+async function resolveCustomerOverlayId(em, customerIds, store) {
+  if (customerIds.length === 0) return null;
+  const rows = await em.getKysely().selectFrom("catalog_product_variant_prices").select("customer_id").distinct().where("customer_id", "in", customerIds).where("tenant_id", "=", store.tenantId).where("organization_id", "=", store.organizationId).execute();
+  const withOwnRows = new Set(rows.map((row) => row.customer_id).filter((id) => typeof id === "string"));
+  const overlayIds = customerIds.filter((id) => withOwnRows.has(id));
+  return overlayIds.length > 0 ? overlayIds.join(",") : null;
+}
+async function resolveEffectiveAssortment(service, tenantId, channelAssortmentScope, identity) {
+  const buyerScope = await service.resolveAssortmentScope({
+    customerId: identity.customerId,
+    customerIds: identity.customerIds,
+    tenantId
+  });
+  return intersectScopes(channelAssortmentScope, buyerScope.scope);
+}
+async function resolveAnonymousAssortmentScope(container, input) {
+  if (input.requireAuthentication) return [];
+  const service = requireService(container, "customerGroupsService");
+  return resolveEffectiveAssortment(service, input.tenantId, input.channelAssortmentScope, ANONYMOUS_IDENTITY);
+}
+async function reportEmptyAssortment(container, store, assortmentScopeHash) {
+  const cache = ecommerceResolutionCache(container);
+  const key = ["assortment-empty", store.store.id, store.channel.channelBindingId, assortmentScopeHash];
+  const alreadyReported = await cache.get(key);
+  if (alreadyReported) return;
+  await cache.set(key, { reportedAt: (/* @__PURE__ */ new Date()).toISOString() }, { ttlMs: ASSORTMENT_EMPTY_THROTTLE_MS });
+  logger.warn("Authenticated buyer resolved to an empty assortment", {
+    storeId: store.store.id,
+    channelBindingId: store.channel.channelBindingId,
+    assortmentScopeHash
+  });
+  try {
+    await emitEcommerceEvent(
+      "ecommerce.assortment.empty_detected",
+      {
+        id: store.store.id,
+        storeId: store.store.id,
+        channelBindingId: store.channel.channelBindingId,
+        assortmentScopeHash,
+        tenantId: store.tenantId,
+        organizationId: store.organizationId
+      },
+      { persistent: true, tenantId: store.tenantId, organizationId: store.organizationId }
+    );
+  } catch (error) {
+    logger.warn("Failed to emit empty assortment event", { storeId: store.store.id, err: error });
+    getTelemetryRuntime()?.reportError(error, {
+      module: "ecommerce",
+      code: "ecommerce.assortment_empty_emit_failed",
+      attributes: { storeId: store.store.id }
+    });
+  }
+}
+function isClosedToBuyer(store, identity) {
+  return store.channel.requireAuthentication && !identity.isAuthenticated;
+}
+async function resolveBuyerGroupLayer(container, store, identity) {
+  if (isClosedToBuyer(store, identity)) {
+    return {
+      customerGroupIds: [],
+      priceKindId: store.channel.priceKindId ?? null,
+      allowPurchaseOnAccount: false,
+      approvalRequiredAbove: null,
+      assortmentScope: []
+    };
+  }
+  const service = requireService(container, "customerGroupsService");
+  const groups = await service.resolveGroups({
+    customerId: identity.customerId,
+    customerIds: identity.customerIds,
+    tenantId: store.tenantId
+  });
+  const terms = await service.resolveTerms({
+    customerId: identity.customerId,
+    customerIds: identity.customerIds,
+    tenantId: store.tenantId,
+    groupIds: groups.groupIds
+  });
+  return {
+    customerGroupIds: groups.groupIds,
+    priceKindId: terms.priceKindId ?? store.channel.priceKindId ?? null,
+    allowPurchaseOnAccount: terms.allowPurchaseOnAccount,
+    approvalRequiredAbove: terms.approvalRequiredAbove,
+    assortmentScope: await resolveEffectiveAssortment(
+      service,
+      store.tenantId,
+      store.channel.assortmentScope,
+      identity
+    )
+  };
+}
+async function buildBuyerContext(container, store, identity) {
+  const em = requireService(container, "em");
+  const { customerGroupIds, priceKindId, allowPurchaseOnAccount, approvalRequiredAbove, assortmentScope } = await resolveBuyerGroupLayer(container, store, identity);
+  const taxMode = await resolveTaxMode(em, priceKindId, store);
+  const assortmentScopeHash = hashEffectiveScope(assortmentScope);
+  if (identity.isAuthenticated && Array.isArray(assortmentScope) && assortmentScope.length === 0) {
+    await reportEmptyAssortment(container, store, assortmentScopeHash);
+  }
+  const customerOverlayId = await resolveCustomerOverlayId(em, identity.customerIds, store);
+  return {
+    ...identity,
+    customerGroupIds,
+    taxMode,
+    priceKindId,
+    allowPurchaseOnAccount,
+    approvalRequiredAbove,
+    assortmentScope,
+    assortmentScopeHash,
+    priceScopeKey: computePriceScopeKey({
+      channelId: store.channel.salesChannelId,
+      currencyCode: store.currencyCode,
+      priceKindId,
+      customerGroupIds
+    }),
+    customerOverlayId
+  };
+}
+async function readPortalSession(request) {
+  const { getCustomerAuthFromRequest } = await import("@open-mercato/core/modules/customer_accounts/lib/customerAuth");
+  return getCustomerAuthFromRequest(request);
+}
+async function resolveBuyerContext(container, store, request) {
+  const auth = request ? await readPortalSession(request) : null;
+  if (auth && (auth.tenantId !== store.tenantId || auth.orgId !== store.organizationId)) {
+    logger.debug("Portal session scope does not match the resolved store", { storeId: store.store.id });
+    throw new StorefrontResolutionError(401, "portal_session_scope_mismatch");
+  }
+  const customerUserId = auth?.sub ?? null;
+  const cache = buyerContextCache(container, { tenantId: store.tenantId, storeId: store.store.id });
+  const cached = await cache.get(customerUserId);
+  if (cached && cached.customerUserId === customerUserId) return cached;
+  const identity = customerUserId ? await loadBuyerIdentity(requireService(container, "em"), customerUserId, store) : ANONYMOUS_IDENTITY;
+  const buyer = await buildBuyerContext(container, store, identity);
+  await cache.set(buyer);
+  return buyer;
+}
+function composeStoreContext(store, buyer) {
+  return {
+    store: store.store,
+    tenantId: store.tenantId,
+    organizationId: store.organizationId,
+    channel: {
+      channelBindingId: store.channel.channelBindingId,
+      salesChannelId: store.channel.salesChannelId,
+      priceKindId: store.channel.priceKindId,
+      priceSortFallback: store.channel.priceSortFallback
+    },
+    buyer,
+    effectiveLocale: store.effectiveLocale,
+    requestedLocale: store.requestedLocale,
+    currencyCode: store.currencyCode,
+    digest: computeStoreContextDigest({
+      storeId: store.store.id,
+      effectiveLocale: store.effectiveLocale,
+      taxMode: buyer.taxMode,
+      priceScopeKey: buyer.priceScopeKey,
+      assortmentScopeHash: buyer.assortmentScopeHash,
+      customerOverlayId: buyer.customerOverlayId
+    })
+  };
+}
+export {
+  ASSORTMENT_EMPTY_THROTTLE_MS,
+  buyerIdentityFromCustomerUser,
+  composeStoreContext,
+  computePriceScopeKey,
+  computeStoreContextDigest,
+  resolveAnonymousAssortmentScope,
+  resolveBuyerContext,
+  taxModeFromPriceKindDisplayMode
+};
+//# sourceMappingURL=buyerContext.js.map