@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/product-scope-context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-scope-context.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/product-scope-context.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAGhB,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAHjB,SAAS,EAAE,MAAM,aAAa,EAC9B,sBAAsB,EAAE,0BAA0B,EAClD,eAAe,EAAE,gBAAgB,EACjC,iBAAiB,EAAE,+BAA+B;IAG/D,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC;IAqEvC;;;OAGG;IACG,8BAA8B,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAehB,oEAAoE;IACpE,qBAAqB,IAAI,OAAO,uBAAuB;CAGxD"}

package/dist/backend/services/product-scope-context.service.js

@@ -0,0 +1,106 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Product } from '../entities/product.entity.js';
+import { ProductEditorPreference } from '../entities/product-editor-preference.entity.js';
+/**
+ * Feature 022 — assembles the response of
+ * `GET /admin/products/:id/scope-context`.
+ *
+ * Combines:
+ *   - the product's assigned channels (via SalesChannelMembershipPort),
+ *     each carrying its language list (`SalesChannel.languages` JSONB),
+ *   - the union of those languages,
+ *   - the platform's primary admin language (LanguageService.getDefault()),
+ *   - the editor's remembered context (ProductEditorPreference).
+ *
+ * If the product has zero assigned channels, `languagesUnion` falls
+ * back to every active platform language so the editor can still
+ * translate the global baseline.
+ */
+export class ProductScopeContextService {
+    emFactory;
+    salesChannelMembership;
+    languageService;
+    editorPreferences;
+    constructor(emFactory, salesChannelMembership, languageService, editorPreferences) {
+        this.emFactory = emFactory;
+        this.salesChannelMembership = salesChannelMembership;
+        this.languageService = languageService;
+        this.editorPreferences = editorPreferences;
+    }
+    async getContext(productId, adminUserId) {
+        const em = this.emFactory();
+        // 1. Ensure the product exists (or surface a clean 404).
+        const product = await em.findOne(Product, { id: productId });
+        if (!product) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Product not found.');
+        }
+        // 2. Channels the product is assigned to. Each channel carries its
+        //    language list directly on the entity.
+        const channels = await this.salesChannelMembership.listChannelsForEntity('product', productId);
+        const channelDtos = channels
+            .map((c) => {
+            const name = (typeof c.name === 'object' && c.name !== null
+                ? Object.values(c.name).find((v) => typeof v === 'string' && v.length > 0)
+                : null) ?? c.code;
+            return {
+                id: c.id,
+                code: c.code,
+                name,
+                languages: [...c.languages].sort(),
+                isDefault: c.systemDefault,
+            };
+        })
+            .sort((a, b) => a.code.localeCompare(b.code));
+        // 3. Union of channel languages. When the product is in zero
+        //    channels, fall back to every active platform language so the
+        //    editor still has a viable language list.
+        let languagesUnion;
+        if (channelDtos.length === 0) {
+            const activeLangs = await this.languageService.listActive();
+            languagesUnion = activeLangs.map((l) => l.code).sort();
+        }
+        else {
+            const unionSet = new Set();
+            for (const c of channelDtos)
+                for (const code of c.languages)
+                    unionSet.add(code);
+            languagesUnion = [...unionSet].sort();
+        }
+        // 4. Primary admin language — default Language row if present, else
+        //    the first available active language, else 'en' as a last resort.
+        const defaultLang = await this.languageService.getDefault();
+        let primaryAdminLanguage = defaultLang?.code;
+        if (!primaryAdminLanguage) {
+            const actives = await this.languageService.listActive();
+            primaryAdminLanguage = actives[0]?.code ?? 'en';
+        }
+        // 5. Editor preference — null if no prior visit.
+        const pref = await this.editorPreferences.find(adminUserId, productId);
+        const preference = pref
+            ? { lastChannelId: pref.lastChannelId ?? null, lastLanguageCode: pref.lastLanguageCode ?? null }
+            : null;
+        return {
+            productId,
+            channels: channelDtos,
+            languagesUnion,
+            primaryAdminLanguage,
+            preference,
+        };
+    }
+    /**
+     * Validate that a remembered preference is still applicable for the
+     * given product. Used by the PUT editor-preference endpoint.
+     */
+    async assertChannelAssignedToProduct(productId, channelId) {
+        const channels = await this.salesChannelMembership.listChannelsForEntity('product', productId);
+        if (!channels.some((c) => c.id === channelId)) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'channel_not_assigned_to_product', [{ path: 'lastChannelId', issue: channelId }]);
+        }
+    }
+    /** Re-export for tests + consumers needing direct entity access. */
+    preferenceEntityClass() {
+        return ProductEditorPreference;
+    }
+}
+//# sourceMappingURL=product-scope-context.service.js.map

package/dist/backend/services/product-scope-context.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-scope-context.service.js","sourceRoot":"","sources":["../../../src/backend/services/product-scope-context.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/product-type-validations.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure validation helpers for the Product type domain (feature 002,
+ * data-model.md §1.1).
+ *
+ * Implementation lands in T047. This module currently exposes only
+ * the type surface and stubs that throw `not implemented` so the
+ * failing unit test (T040) compiles.
+ */
+export type ProductTypeValidationCode = 'CONFIGURABLE_REQUIRES_VARIANT' | 'VIRTUAL_DOWNLOAD_EXACTLY_ONE' | 'NON_VIRTUAL_HAS_DOWNLOAD_FIELDS';
+export declare class ProductTypeValidationError extends Error {
+    readonly code: ProductTypeValidationCode;
+    constructor(message: string, code: ProductTypeValidationCode);
+}
+export interface ProductTypeForVariantCheck {
+    type: 'simple' | 'configurable' | 'grouped' | 'bundle' | 'virtual';
+    variantCount: number;
+}
+/**
+ * Reject a configurable Product that has zero variants. Other types
+ * are accepted regardless of `variantCount`.
+ *
+ * Throws ProductTypeValidationError with code
+ * CONFIGURABLE_REQUIRES_VARIANT.
+ */
+export declare function assertConfigurableHasVariants(input: ProductTypeForVariantCheck): void;
+export interface ProductTypeForDownloadCheck {
+    type: 'simple' | 'configurable' | 'grouped' | 'bundle' | 'virtual';
+    downloadAssetId: string | null;
+    downloadUrl: string | null;
+}
+/**
+ * Cross-field validation of `downloadAssetId` / `downloadUrl` against
+ * the Product type:
+ *   - virtual: exactly one of the two MUST be set.
+ *   - non-virtual: BOTH MUST be null.
+ *
+ * Throws ProductTypeValidationError with one of:
+ *   - VIRTUAL_DOWNLOAD_EXACTLY_ONE
+ *   - NON_VIRTUAL_HAS_DOWNLOAD_FIELDS
+ */
+export declare function assertVirtualDownloadFields(input: ProductTypeForDownloadCheck): void;
+//# sourceMappingURL=product-type-validations.d.ts.map

package/dist/backend/services/product-type-validations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-type-validations.d.ts","sourceRoot":"","sources":["../../../src/backend/services/product-type-validations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,yBAAyB,GACjC,+BAA+B,GAC/B,8BAA8B,GAC9B,iCAAiC,CAAC;AAEtC,qBAAa,0BAA2B,SAAQ,KAAK;aAGjC,IAAI,EAAE,yBAAyB;gBAD/C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,yBAAyB;CAKlD;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,GAChC,IAAI,CAON;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,2BAA2B,GACjC,IAAI,CAoBN"}

package/dist/backend/services/product-type-validations.js

@@ -0,0 +1,55 @@
+/**
+ * Pure validation helpers for the Product type domain (feature 002,
+ * data-model.md §1.1).
+ *
+ * Implementation lands in T047. This module currently exposes only
+ * the type surface and stubs that throw `not implemented` so the
+ * failing unit test (T040) compiles.
+ */
+export class ProductTypeValidationError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ProductTypeValidationError';
+    }
+}
+/**
+ * Reject a configurable Product that has zero variants. Other types
+ * are accepted regardless of `variantCount`.
+ *
+ * Throws ProductTypeValidationError with code
+ * CONFIGURABLE_REQUIRES_VARIANT.
+ */
+export function assertConfigurableHasVariants(input) {
+    if (input.type !== 'configurable')
+        return;
+    if (input.variantCount > 0)
+        return;
+    throw new ProductTypeValidationError('configurable products require at least one Variant.', 'CONFIGURABLE_REQUIRES_VARIANT');
+}
+/**
+ * Cross-field validation of `downloadAssetId` / `downloadUrl` against
+ * the Product type:
+ *   - virtual: exactly one of the two MUST be set.
+ *   - non-virtual: BOTH MUST be null.
+ *
+ * Throws ProductTypeValidationError with one of:
+ *   - VIRTUAL_DOWNLOAD_EXACTLY_ONE
+ *   - NON_VIRTUAL_HAS_DOWNLOAD_FIELDS
+ */
+export function assertVirtualDownloadFields(input) {
+    const hasAsset = input.downloadAssetId !== null;
+    const hasUrl = input.downloadUrl !== null;
+    if (input.type === 'virtual') {
+        if (hasAsset !== hasUrl)
+            return; // exactly one of
+        throw new ProductTypeValidationError(hasAsset && hasUrl
+            ? 'virtual products MUST set exactly one of downloadAssetId / downloadUrl, not both.'
+            : 'virtual products MUST set exactly one of downloadAssetId / downloadUrl.', 'VIRTUAL_DOWNLOAD_EXACTLY_ONE');
+    }
+    if (hasAsset || hasUrl) {
+        throw new ProductTypeValidationError(`non-virtual products (type=${input.type}) MUST have both downloadAssetId and downloadUrl null.`, 'NON_VIRTUAL_HAS_DOWNLOAD_FIELDS');
+    }
+}
+//# sourceMappingURL=product-type-validations.js.map

package/dist/backend/services/product-type-validations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-type-validations.js","sourceRoot":"","sources":["../../../src/backend/services/product-type-validations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGjC;IAFlB,YACE,OAAe,EACC,IAA+B;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAA2B;QAG/C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAiC;IAEjC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO;IAC1C,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC;QAAE,OAAO;IACnC,MAAM,IAAI,0BAA0B,CAClC,qDAAqD,EACrD,+BAA+B,CAChC,CAAC;AACJ,CAAC;AAQD;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAkC;IAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC;IAE1C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,QAAQ,KAAK,MAAM;YAAE,OAAO,CAAC,iBAAiB;QAClD,MAAM,IAAI,0BAA0B,CAClC,QAAQ,IAAI,MAAM;YAChB,CAAC,CAAC,mFAAmF;YACrF,CAAC,CAAC,yEAAyE,EAC7E,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,0BAA0B,CAClC,8BAA8B,KAAK,CAAC,IAAI,wDAAwD,EAChG,iCAAiC,CAClC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/backend/services/product-value-resolver.service.d.ts

@@ -0,0 +1,59 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type AttributeScope, type OverrideRow, type Resolved, type ResolveAllResult, type LanguageReadPort, type ResolverContext } from '@endora-commerce/contracts';
+import type { Product } from '../entities/product.entity.js';
+import type { CatalogAttributeReadService } from './catalog-attribute-read.service.js';
+/**
+ * Feature 022 — backend wrapper around the pure resolver in
+ * `@endora-commerce/contracts`. Handles the EM-side concerns:
+ *   - fetching the override map for a product in a single SELECT,
+ *   - assembling AttributeDefs for the system + user-defined attrs,
+ *   - resolving the platform's primary admin language.
+ *
+ * The actual fallback-chain logic lives in `@endora-commerce/contracts` so the
+ * admin SPA imports the same code (guaranteeing server / client
+ * agreement — SC-004).
+ */
+export declare class ProductValueResolverService {
+    private readonly emFactory;
+    private readonly languageService;
+    /** Feature 061 — composed attribute read model (scope lookups). */
+    private readonly attributeRead?;
+    constructor(emFactory: () => EntityManager, languageService: LanguageReadPort, 
+    /** Feature 061 — composed attribute read model (scope lookups). */
+    attributeRead?: CatalogAttributeReadService | undefined);
+    /** Load every override row for a product in one query. */
+    loadOverrides(productId: string): Promise<OverrideRow[]>;
+    /** Resolve the platform's primary admin language. */
+    getPrimaryAdminLanguage(): Promise<string>;
+    /**
+     * Build a ResolverContext from a (channelId, languageCode) pair,
+     * filling in the primary admin language.
+     */
+    makeContext(channelId: string | null, languageCode: string | null): Promise<ResolverContext>;
+    /**
+     * Resolve every attribute for the given product in one pass: system
+     * Name + Description plus every user-defined attribute defined in the
+     * `product_attributes` table whose value is present in
+     * `attribute_values` JSONB (or every row in the assigned set, see
+     * below).
+     *
+     * For simplicity this implementation walks the union of (a) the
+     * product's `attributeValues` keys and (b) `SYSTEM_ATTRIBUTE_SCOPES`.
+     * Attributes defined in the assigned `AttributeSet` but currently
+     * empty are skipped — the admin UI re-introduces them when binding
+     * fields. The resolver tolerates empty inputs gracefully.
+     */
+    resolveForProduct(product: Product, ctx: ResolverContext): Promise<ResolveAllResult>;
+    /**
+     * Resolve a single attribute. Convenience for handlers that only need
+     * Name or Description (e.g., the public PDP route).
+     */
+    resolveOne(args: {
+        baseline: unknown;
+        overrides: readonly OverrideRow[];
+        attributeKey: string;
+        scope: AttributeScope;
+        ctx: ResolverContext;
+    }): Resolved;
+}
+//# sourceMappingURL=product-value-resolver.service.d.ts.map

package/dist/backend/services/product-value-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-value-resolver.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/product-value-resolver.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAMvF;;;;;;;;;;GAUG;AACH,qBAAa,2BAA2B;IAEpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAHd,SAAS,EAAE,MAAM,aAAa,EAC9B,eAAe,EAAE,gBAAgB;IAClD,mEAAmE;IAClD,aAAa,CAAC,EAAE,2BAA2B,YAAA;IAG9D,0DAA0D;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAW9D,qDAAqD;IAC/C,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAOhD;;;OAGG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,eAAe,CAAC;IAK3B;;;;;;;;;;;;OAYG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,gBAAgB,CAAC;IA+C5B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;QAClC,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,cAAc,CAAC;QACtB,GAAG,EAAE,eAAe,CAAC;KACtB,GAAG,QAAQ;CAGb"}

package/dist/backend/services/product-value-resolver.service.js

@@ -0,0 +1,111 @@
+import { resolveAttribute, resolveAll, } from '@endora-commerce/contracts';
+import { ProductValueOverride } from '../entities/product-value-override.entity.js';
+import { SYSTEM_ATTRIBUTE_SCOPES, } from './system-attribute-scopes.js';
+/**
+ * Feature 022 — backend wrapper around the pure resolver in
+ * `@endora-commerce/contracts`. Handles the EM-side concerns:
+ *   - fetching the override map for a product in a single SELECT,
+ *   - assembling AttributeDefs for the system + user-defined attrs,
+ *   - resolving the platform's primary admin language.
+ *
+ * The actual fallback-chain logic lives in `@endora-commerce/contracts` so the
+ * admin SPA imports the same code (guaranteeing server / client
+ * agreement — SC-004).
+ */
+export class ProductValueResolverService {
+    emFactory;
+    languageService;
+    attributeRead;
+    constructor(emFactory, languageService, 
+    /** Feature 061 — composed attribute read model (scope lookups). */
+    attributeRead) {
+        this.emFactory = emFactory;
+        this.languageService = languageService;
+        this.attributeRead = attributeRead;
+    }
+    /** Load every override row for a product in one query. */
+    async loadOverrides(productId) {
+        const em = this.emFactory();
+        const rows = await em.find(ProductValueOverride, { productId });
+        return rows.map((r) => ({
+            attributeKey: r.attributeKey,
+            channelId: r.channelId,
+            languageCode: r.languageCode ?? null,
+            value: r.value,
+        }));
+    }
+    /** Resolve the platform's primary admin language. */
+    async getPrimaryAdminLanguage() {
+        const def = await this.languageService.getDefault();
+        if (def)
+            return def.code;
+        const actives = await this.languageService.listActive();
+        return actives[0]?.code ?? 'en';
+    }
+    /**
+     * Build a ResolverContext from a (channelId, languageCode) pair,
+     * filling in the primary admin language.
+     */
+    async makeContext(channelId, languageCode) {
+        const primaryLanguage = await this.getPrimaryAdminLanguage();
+        return { channelId, languageCode, primaryLanguage };
+    }
+    /**
+     * Resolve every attribute for the given product in one pass: system
+     * Name + Description plus every user-defined attribute defined in the
+     * `product_attributes` table whose value is present in
+     * `attribute_values` JSONB (or every row in the assigned set, see
+     * below).
+     *
+     * For simplicity this implementation walks the union of (a) the
+     * product's `attributeValues` keys and (b) `SYSTEM_ATTRIBUTE_SCOPES`.
+     * Attributes defined in the assigned `AttributeSet` but currently
+     * empty are skipped — the admin UI re-introduces them when binding
+     * fields. The resolver tolerates empty inputs gracefully.
+     */
+    async resolveForProduct(product, ctx) {
+        const overrides = await this.loadOverrides(product.id);
+        const userAttrKeys = Object.keys(product.attributeValues ?? {});
+        // Look up user-defined attribute metadata through the composed view
+        // (feature 061 — the key/scope pair spans definition + extension).
+        if (!this.attributeRead) {
+            throw new Error('ProductValueResolverService: CatalogAttributeReadService is not wired — attribute reads are unavailable.');
+        }
+        const wantedKeys = new Set(userAttrKeys);
+        const userAttrRows = userAttrKeys.length === 0
+            ? []
+            : (await this.attributeRead.listAll()).filter((v) => wantedKeys.has(v.key));
+        const userAttrByKey = new Map(userAttrRows.map((r) => [r.key, r]));
+        const defs = [];
+        // System attributes — their baseline lives directly on the product.
+        for (const sysKey of Object.keys(SYSTEM_ATTRIBUTE_SCOPES)) {
+            const baseline = sysKey === 'name' ? product.name : sysKey === 'description' ? product.description : null;
+            defs.push({
+                attributeKey: sysKey,
+                scope: SYSTEM_ATTRIBUTE_SCOPES[sysKey],
+                baseline,
+            });
+        }
+        // User-defined attributes — baseline is product.attributeValues[key].
+        for (const key of userAttrKeys) {
+            const row = userAttrByKey.get(key);
+            const scope = row
+                ? { channelScoped: row.channelScoped, languageScoped: row.languageScoped }
+                : { channelScoped: false, languageScoped: false };
+            defs.push({
+                attributeKey: key,
+                scope,
+                baseline: product.attributeValues[key],
+            });
+        }
+        return resolveAll(defs, overrides, ctx);
+    }
+    /**
+     * Resolve a single attribute. Convenience for handlers that only need
+     * Name or Description (e.g., the public PDP route).
+     */
+    resolveOne(args) {
+        return resolveAttribute(args);
+    }
+}
+//# sourceMappingURL=product-value-resolver.service.js.map

package/dist/backend/services/product-value-resolver.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-value-resolver.service.js","sourceRoot":"","sources":["../../../src/backend/services/product-value-resolver.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/system-attribute-scopes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Feature 022 — scope flags for the **system** product attributes that are NOT
+ * rows in `product_attributes` (and therefore do not carry their own DB-stored
+ * scope flags).
+ *
+ * All four declarations moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013). `SYSTEM_ATTRIBUTE_SCOPES` is a constant and `getAttributeScope` a
+ * pure function over it: `name` and `description` are channel- and
+ * language-scoped because the product table stores them as per-locale JSONB,
+ * which is a fact about the schema rather than about whether a module is
+ * switched on. A gated port answering 503 to "is this key channel-scoped"
+ * would be a bug.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer —
+ * `search`'s indexer still names this path.
+ */
+export { SYSTEM_ATTRIBUTE_SCOPES, type SystemAttributeKey, isSystemAttributeKey, getAttributeScope, } from '@endora-commerce/contracts';
+//# sourceMappingURL=system-attribute-scopes.d.ts.map

package/dist/backend/services/system-attribute-scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-attribute-scopes.d.ts","sourceRoot":"","sources":["../../../src/backend/services/system-attribute-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/system-attribute-scopes.js

@@ -0,0 +1,18 @@
+/**
+ * Feature 022 — scope flags for the **system** product attributes that are NOT
+ * rows in `product_attributes` (and therefore do not carry their own DB-stored
+ * scope flags).
+ *
+ * All four declarations moved to `@endora-commerce/contracts` in feature 075's Phase P
+ * (FR-013). `SYSTEM_ATTRIBUTE_SCOPES` is a constant and `getAttributeScope` a
+ * pure function over it: `name` and `description` are channel- and
+ * language-scoped because the product table stores them as per-locale JSONB,
+ * which is a fact about the schema rather than about whether a module is
+ * switched on. A gated port answering 503 to "is this key channel-scoped"
+ * would be a bug.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer —
+ * `search`'s indexer still names this path.
+ */
+export { SYSTEM_ATTRIBUTE_SCOPES, isSystemAttributeKey, getAttributeScope, } from '@endora-commerce/contracts';
+//# sourceMappingURL=system-attribute-scopes.js.map

package/dist/backend/services/system-attribute-scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-attribute-scopes.js","sourceRoot":"","sources":["../../../src/backend/services/system-attribute-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,uBAAuB,EAEvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/viewer-organization.d.ts

@@ -0,0 +1,25 @@
+import type { OrganizationDetailsPort, PriceOrganization, ProductAudience } from '@endora-commerce/contracts';
+/**
+ * The buying organisation the pricing engine should resolve a catalogue price
+ * against, for the viewer in front of this page — or `null` when there is none.
+ *
+ * `null` covers three callers, and they get the channel price for three
+ * different reasons that happen to agree:
+ *
+ *  - the **anonymous** visitor and the crawler, who have no identity to price
+ *    for and whose answer has to stay the canonical, cacheable, indexable one;
+ *  - the **signed-in buyer with no Organization** — feature 026's guest-style
+ *    account, and an unbound API key. Authenticated, and with no negotiated
+ *    list to resolve against, so the channel price is not a fallback but the
+ *    right answer;
+ *  - the buyer whose Organization row is **gone**. That one answers with the
+ *    channel price rather than throwing, for the reason `comparisons` states at
+ *    the same seam: a missing row is not a reason to refuse a catalogue.
+ *
+ * Shared by `CatalogQueryService` and `ProductLinkService` because a PDP calls
+ * both — the hero price and the cross-sell tiles under it come out of one
+ * request, and two derivations of "who is asking" is two chances to answer it
+ * differently on one page.
+ */
+export declare function viewerOrganizationFor(organizations: OrganizationDetailsPort, audience: ProductAudience): Promise<PriceOrganization | null>;
+//# sourceMappingURL=viewer-organization.d.ts.map

package/dist/backend/services/viewer-organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-organization.d.ts","sourceRoot":"","sources":["../../../src/backend/services/viewer-organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,uBAAuB,EACtC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKnC"}

package/dist/backend/services/viewer-organization.js

@@ -0,0 +1,31 @@
+/**
+ * The buying organisation the pricing engine should resolve a catalogue price
+ * against, for the viewer in front of this page — or `null` when there is none.
+ *
+ * `null` covers three callers, and they get the channel price for three
+ * different reasons that happen to agree:
+ *
+ *  - the **anonymous** visitor and the crawler, who have no identity to price
+ *    for and whose answer has to stay the canonical, cacheable, indexable one;
+ *  - the **signed-in buyer with no Organization** — feature 026's guest-style
+ *    account, and an unbound API key. Authenticated, and with no negotiated
+ *    list to resolve against, so the channel price is not a fallback but the
+ *    right answer;
+ *  - the buyer whose Organization row is **gone**. That one answers with the
+ *    channel price rather than throwing, for the reason `comparisons` states at
+ *    the same seam: a missing row is not a reason to refuse a catalogue.
+ *
+ * Shared by `CatalogQueryService` and `ProductLinkService` because a PDP calls
+ * both — the hero price and the cross-sell tiles under it come out of one
+ * request, and two derivations of "who is asking" is two chances to answer it
+ * differently on one page.
+ */
+export async function viewerOrganizationFor(organizations, audience) {
+    if (audience.organizationId === null)
+        return null;
+    const record = await organizations.findById(audience.organizationId);
+    if (!record)
+        return null;
+    return { id: record.id, customerGroupId: record.customerGroupId };
+}
+//# sourceMappingURL=viewer-organization.js.map

package/dist/backend/services/viewer-organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-organization.js","sourceRoot":"","sources":["../../../src/backend/services/viewer-organization.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAAsC,EACtC,QAAyB;IAEzB,IAAI,QAAQ,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;AACpE,CAAC"}