@endora-commerce/mod-catalog 0.100.0

package/dist/backend/entities/product-value-override.entity.js

@@ -0,0 +1,90 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * ProductValueOverride — feature 022.
+ *
+ * Stores channel-aware overrides for product attribute values. The
+ * global baseline lives on `products.name` / `products.description`
+ * (per-language JSONB) and `products.attribute_values` (per-attribute
+ * JSONB) — this entity only holds the (channel, [language]) slots.
+ *
+ * The resolver in `services/product-value-resolver.ts` (and its
+ * pure-function twin in `@endora-commerce/contracts`) fuses baseline + overrides
+ * into an effective value per (channel, language) context using the
+ * fallback chain documented in
+ * specs/023-product-scope-editor/data-model.md §3.2.
+ *
+ * `attributeKey` is a string — for user-defined attributes it matches
+ * `product_attributes.key`; for system attributes it is one of the
+ * reserved values `'name'` or `'description'` (see
+ * services/system-attribute-scopes.ts). There is no FK from
+ * `attribute_key` to `product_attributes` because system attributes
+ * are not rows there.
+ *
+ * `languageCode` is NULLABLE — a NULL row models a channel-only
+ * override (attribute is channel-scoped but not language-scoped);
+ * a non-null row models a channel+language override. Two partial
+ * UNIQUE indexes (see migration 043) enforce uniqueness across both
+ * shapes.
+ */
+let ProductValueOverride = class ProductValueOverride {
+    [OptionalProps];
+    id = randomUUID();
+    productId;
+    attributeKey;
+    channelId;
+    languageCode;
+    /** Wrapped as `{ v: ... }` so the column is always a JSONB object. */
+    value;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], ProductValueOverride.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], ProductValueOverride.prototype, "productId", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], ProductValueOverride.prototype, "attributeKey", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    __metadata("design:type", String)
+], ProductValueOverride.prototype, "channelId", void 0);
+__decorate([
+    Property({ type: 'string', length: 16, nullable: true }),
+    __metadata("design:type", Object)
+], ProductValueOverride.prototype, "languageCode", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Object)
+], ProductValueOverride.prototype, "value", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], ProductValueOverride.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], ProductValueOverride.prototype, "updatedAt", void 0);
+ProductValueOverride = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'product_value_overrides' })
+], ProductValueOverride);
+export { ProductValueOverride };
+//# sourceMappingURL=product-value-override.entity.js.map

package/dist/backend/entities/product-value-override.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-value-override.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/product-value-override.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,CAAC,aAAa,CAAC,CAAqD;IAGpE,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,SAAS,CAAU;IAGnB,YAAY,CAAU;IAGtB,SAAS,CAAU;IAGnB,YAAY,CAAiB;IAE7B,sEAAsE;IAEtE,KAAK,CAAkB;IAGvB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAxBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;uDACW;AAGnB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;0DACnB;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDACR;AAGnB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0DAC5B;AAI7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;mDACJ;AAGvB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;uDAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;uDAAc;AA3BlB,oBAAoB;IAFhC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,yBAAyB,EAAE,CAAC;GACpC,oBAAoB,CA4BhC"}

package/dist/backend/entities/product-variant.entity.d.ts

@@ -0,0 +1,18 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Concrete variant of a `type=variant` Product.
+ * `variantAttributeValues` contains only keys where the parent's ProductAttribute
+ * has isVariantAxis=true.
+ */
+export declare class ProductVariant {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'priceOverride' | 'stockLevel';
+    id: string;
+    parentProductId: string;
+    sku: string;
+    variantAttributeValues: Record<string, unknown>;
+    priceOverride?: string | null;
+    stockLevel?: number | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=product-variant.entity.d.ts.map

package/dist/backend/entities/product-variant.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-variant.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/product-variant.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;;GAIG;AACH,qBAEa,cAAc;IACzB,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,YAAY,CAAC;IAGpF,EAAE,EAAE,MAAM,CAAgB;IAI1B,eAAe,EAAG,MAAM,CAAC;IAIzB,GAAG,EAAG,MAAM,CAAC;IAGb,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAGrD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3B,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/product-variant.entity.js

@@ -0,0 +1,68 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Concrete variant of a `type=variant` Product.
+ * `variantAttributeValues` contains only keys where the parent's ProductAttribute
+ * has isVariantAxis=true.
+ */
+let ProductVariant = class ProductVariant {
+    [OptionalProps];
+    id = randomUUID();
+    parentProductId;
+    sku;
+    variantAttributeValues = {};
+    priceOverride;
+    stockLevel;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], ProductVariant.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], ProductVariant.prototype, "parentProductId", void 0);
+__decorate([
+    Property({ type: 'string', length: 255 }),
+    Unique(),
+    __metadata("design:type", String)
+], ProductVariant.prototype, "sku", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Object)
+], ProductVariant.prototype, "variantAttributeValues", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 12, scale: 2, nullable: true }),
+    __metadata("design:type", Object)
+], ProductVariant.prototype, "priceOverride", void 0);
+__decorate([
+    Property({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], ProductVariant.prototype, "stockLevel", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], ProductVariant.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], ProductVariant.prototype, "updatedAt", void 0);
+ProductVariant = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'product_variants' })
+], ProductVariant);
+export { ProductVariant };
+//# sourceMappingURL=product-variant.entity.js.map

package/dist/backend/entities/product-variant.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-variant.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/product-variant.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,CAAC,aAAa,CAAC,CAAqE;IAGpF,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,eAAe,CAAU;IAIzB,GAAG,CAAU;IAGb,sBAAsB,GAA4B,EAAE,CAAC;IAGrD,aAAa,CAAiB;IAG9B,UAAU,CAAiB;IAG3B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAxBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;0CACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;uDACiB;AAIzB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzC,MAAM,EAAE;;2CACI;AAGb;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;8DAC0B;AAGrD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACzC;AAG9B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACnB;AAG3B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;iDAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;iDAAc;AA3BlB,cAAc;IAF1B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;GAC7B,cAAc,CA4B1B"}

package/dist/backend/entities/product.entity.d.ts

@@ -0,0 +1,108 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Product — the central catalog object. Supports four `type`s (FR-002).
+ * Soft-deleted via `deletedAt` (data-model.md cross-cutting section); inactive
+ * products still resolve from historical Orders, Invoices, RFQs, Shopping Lists
+ * but are excluded from search/filters.
+ *
+ * Multilingual fields (`name`, `description`) are stored as JSONB per
+ * data-model.md; `attributeValues` is a JSONB keyed by ProductAttribute.key.
+ */
+export declare class Product {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'status' | 'stockMode' | 'deletedAt' | 'archivedAt' | 'allowedOrganizationIds' | 'attributeSetId' | 'downloadAssetId' | 'downloadUrl' | 'manageStock' | 'backorderEnabled' | 'lowStockThreshold' | 'lowStockThresholdMode' | 'fulfilmentStrategy' | 'fulfilmentStrategyWarehouseOrder';
+    id: string;
+    sku: string;
+    slug: string;
+    type: 'simple' | 'configurable' | 'grouped' | 'bundle' | 'virtual';
+    status: 'draft' | 'active' | 'inactive';
+    name: Record<string, string>;
+    description: Record<string, string>;
+    /** Per-product override of global stock mode (categorical/numeric/null=inherit). */
+    stockMode?: 'categorical' | 'numeric' | null;
+    visibility: 'public' | 'logged_in_only' | 'organization_restricted';
+    /** JSONB `{ attributeKey: value }` validated against ProductAttribute definitions. */
+    attributeValues: Record<string, unknown>;
+    /**
+     * The organisations allowed to see this product — **this column is the
+     * storage**, not a cache of one. There is no bridge table: the comment that
+     * stood here until issue #227 named a `product_allowed_organizations` M:N
+     * source of truth that no migration has ever created and no query has ever
+     * read, which is worse than stale — it invites a writer to treat this column
+     * as rebuildable from a table that is not there.
+     *
+     * `products.allowed_organization_ids` is `jsonb not null default '[]'::jsonb`
+     * (`db/migrations/20260424T165847_core_foundation_init.ts`), and a read path
+     * that enforces it asks with `@>` containment over the array — the buyer's
+     * organisation id has to be *in* it, rather than the array being compared to
+     * anything.
+     *
+     * Two states an enforcing read must not conflate:
+     *
+     *  - **empty array** — no organisation restriction. Disclosure is then
+     *    `visibility`'s alone.
+     *  - **empty array with `visibility = 'organization_restricted'`** — visible
+     *    to nobody. The restriction was asked for and names no organisation; the
+     *    permissive reading of it would disclose the row to everybody, which is
+     *    the opposite of what the operator saved.
+     *
+     * A non-empty array restricts whatever `visibility` says, `public` included.
+     * Enforcement is per read path and not every path applies it today; the
+     * `CatalogQuickSearchPort` doc block in `@endora-commerce/contracts` states the predicate
+     * for the path that does.
+     *
+     * No foreign key holds these ids, so a deleted organisation leaves its id in
+     * every product that named it. That question — whether the relationship the
+     * old comment imagined should exist — is issue #227's second half and is not
+     * settled here.
+     */
+    allowedOrganizationIds: string[];
+    /**
+     * Attribute Set the Product is wired to (feature 002, data-model.md §1.1).
+     * Backfilled by the attribute-sets init migration to the system Default
+     * set; never null.
+     * Validation of `attributeValues` is performed against this set's
+     * attributes by `catalog-admin.service.ts` (T023).
+     *
+     * Default value matches
+     * `Migration20260429T064146CatalogAttributeSetsInit.DEFAULT_ATTRIBUTE_SET_ID`
+     * — the deterministic UUID of the system Default set. Inlined here as a
+     * literal so the entity has zero migration-package dependencies.
+     */
+    attributeSetId: string;
+    /**
+     * Feature 002 — virtual product download fields (data-model.md §1.1).
+     * Exactly one MUST be set when type='virtual'; both MUST be null
+     * otherwise. Cross-field rule enforced at the service layer (T047).
+     */
+    downloadAssetId?: string | null;
+    downloadUrl?: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    archivedAt?: Date | null;
+    deletedAt?: Date | null;
+    /** When false, the storefront always shows the product as available
+     *  and the cart accepts any quantity (FR-022). */
+    manageStock: boolean;
+    /** When true, the storefront accepts zero-stock checkout and the
+     *  resulting allocation is flagged `is_backorder` (FR-023). */
+    backorderEnabled: boolean;
+    /** Optional integer; when null the product is exempt from
+     *  low-stock alerts (FR-013). Used in `cumulative` mode against the
+     *  product's total on-hand across all warehouses. */
+    lowStockThreshold?: number | null;
+    /**
+     * Determines how `lowStockThreshold` is interpreted:
+     *  - `cumulative` (default): one threshold applied to the cumulative
+     *    on-hand across every warehouse holding stock for the product.
+     *  - `per_warehouse`: the per-(product, warehouse) rows in
+     *    `product_warehouse_low_stock_thresholds` are consulted instead,
+     *    each warehouse evaluated independently against its own threshold.
+     */
+    lowStockThresholdMode: 'cumulative' | 'per_warehouse';
+    /** Per-product override of the global fulfilment strategy (FR-030). */
+    fulfilmentStrategy?: 'any' | 'default_first' | 'lowest_stock_first' | 'highest_stock_first' | 'defined_order' | null;
+    /** When `fulfilment_strategy = 'defined_order'`, the ordered list
+     *  of warehouse UUIDs to walk. */
+    fulfilmentStrategyWarehouseOrder?: string[] | null;
+}
+//# sourceMappingURL=product.entity.d.ts.map

package/dist/backend/entities/product.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/product.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;;;;;;GAQG;AACH,qBAEa,OAAO;IAClB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,GACX,YAAY,GACZ,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,uBAAuB,GACvB,oBAAoB,GACpB,kCAAkC,CAAC;IAGvC,EAAE,EAAE,MAAM,CAAgB;IAI1B,GAAG,EAAG,MAAM,CAAC;IAKb,IAAI,EAAG,MAAM,CAAC;IAGd,IAAI,EAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAIpE,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAW;IAGlD,IAAI,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAG9B,WAAW,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,oFAAoF;IAEpF,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC;IAG7C,UAAU,EAAE,QAAQ,GAAG,gBAAgB,GAAG,yBAAyB,CAAY;IAE/E,sFAAsF;IAEtF,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IAEH,sBAAsB,EAAE,MAAM,EAAE,CAAM;IAEtC;;;;;;;;;;;OAWG;IAEH,cAAc,EAAE,MAAM,CAA0C;IAEhE;;;;OAIG;IAEH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAI5B,SAAS,EAAE,IAAI,CAAc;IAI7B,SAAS,EAAE,IAAI,CAAc;IAI7B,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAGzB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAMxB;sDACkD;IAElD,WAAW,EAAE,OAAO,CAAQ;IAE5B;mEAC+D;IAE/D,gBAAgB,EAAE,OAAO,CAAS;IAElC;;yDAEqD;IAErD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;;;;OAOG;IAEH,qBAAqB,EAAE,YAAY,GAAG,eAAe,CAAgB;IAErE,uEAAuE;IAEvE,kBAAkB,CAAC,EACf,KAAK,GACL,eAAe,GACf,oBAAoB,GACpB,qBAAqB,GACrB,eAAe,GACf,IAAI,CAAC;IAET;sCACkC;IAElC,gCAAgC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACpD"}

package/dist/backend/entities/product.entity.js

@@ -0,0 +1,230 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Product — the central catalog object. Supports four `type`s (FR-002).
+ * Soft-deleted via `deletedAt` (data-model.md cross-cutting section); inactive
+ * products still resolve from historical Orders, Invoices, RFQs, Shopping Lists
+ * but are excluded from search/filters.
+ *
+ * Multilingual fields (`name`, `description`) are stored as JSONB per
+ * data-model.md; `attributeValues` is a JSONB keyed by ProductAttribute.key.
+ */
+let Product = class Product {
+    [OptionalProps];
+    id = randomUUID();
+    sku;
+    slug;
+    type;
+    status = 'draft';
+    name;
+    description;
+    /** Per-product override of global stock mode (categorical/numeric/null=inherit). */
+    stockMode;
+    visibility = 'public';
+    /** JSONB `{ attributeKey: value }` validated against ProductAttribute definitions. */
+    attributeValues = {};
+    /**
+     * The organisations allowed to see this product — **this column is the
+     * storage**, not a cache of one. There is no bridge table: the comment that
+     * stood here until issue #227 named a `product_allowed_organizations` M:N
+     * source of truth that no migration has ever created and no query has ever
+     * read, which is worse than stale — it invites a writer to treat this column
+     * as rebuildable from a table that is not there.
+     *
+     * `products.allowed_organization_ids` is `jsonb not null default '[]'::jsonb`
+     * (`db/migrations/20260424T165847_core_foundation_init.ts`), and a read path
+     * that enforces it asks with `@>` containment over the array — the buyer's
+     * organisation id has to be *in* it, rather than the array being compared to
+     * anything.
+     *
+     * Two states an enforcing read must not conflate:
+     *
+     *  - **empty array** — no organisation restriction. Disclosure is then
+     *    `visibility`'s alone.
+     *  - **empty array with `visibility = 'organization_restricted'`** — visible
+     *    to nobody. The restriction was asked for and names no organisation; the
+     *    permissive reading of it would disclose the row to everybody, which is
+     *    the opposite of what the operator saved.
+     *
+     * A non-empty array restricts whatever `visibility` says, `public` included.
+     * Enforcement is per read path and not every path applies it today; the
+     * `CatalogQuickSearchPort` doc block in `@endora-commerce/contracts` states the predicate
+     * for the path that does.
+     *
+     * No foreign key holds these ids, so a deleted organisation leaves its id in
+     * every product that named it. That question — whether the relationship the
+     * old comment imagined should exist — is issue #227's second half and is not
+     * settled here.
+     */
+    allowedOrganizationIds = [];
+    /**
+     * Attribute Set the Product is wired to (feature 002, data-model.md §1.1).
+     * Backfilled by the attribute-sets init migration to the system Default
+     * set; never null.
+     * Validation of `attributeValues` is performed against this set's
+     * attributes by `catalog-admin.service.ts` (T023).
+     *
+     * Default value matches
+     * `Migration20260429T064146CatalogAttributeSetsInit.DEFAULT_ATTRIBUTE_SET_ID`
+     * — the deterministic UUID of the system Default set. Inlined here as a
+     * literal so the entity has zero migration-package dependencies.
+     */
+    attributeSetId = 'defa0017-0000-4000-8000-000000000000';
+    /**
+     * Feature 002 — virtual product download fields (data-model.md §1.1).
+     * Exactly one MUST be set when type='virtual'; both MUST be null
+     * otherwise. Cross-field rule enforced at the service layer (T047).
+     */
+    downloadAssetId;
+    downloadUrl;
+    createdAt = new Date();
+    updatedAt = new Date();
+    archivedAt;
+    deletedAt;
+    // ----------------------------------------------------------------
+    // Inventory module (feature 010) — per-product stock-management flags
+    // ----------------------------------------------------------------
+    /** When false, the storefront always shows the product as available
+     *  and the cart accepts any quantity (FR-022). */
+    manageStock = true;
+    /** When true, the storefront accepts zero-stock checkout and the
+     *  resulting allocation is flagged `is_backorder` (FR-023). */
+    backorderEnabled = false;
+    /** Optional integer; when null the product is exempt from
+     *  low-stock alerts (FR-013). Used in `cumulative` mode against the
+     *  product's total on-hand across all warehouses. */
+    lowStockThreshold;
+    /**
+     * Determines how `lowStockThreshold` is interpreted:
+     *  - `cumulative` (default): one threshold applied to the cumulative
+     *    on-hand across every warehouse holding stock for the product.
+     *  - `per_warehouse`: the per-(product, warehouse) rows in
+     *    `product_warehouse_low_stock_thresholds` are consulted instead,
+     *    each warehouse evaluated independently against its own threshold.
+     */
+    lowStockThresholdMode = 'cumulative';
+    /** Per-product override of the global fulfilment strategy (FR-030). */
+    fulfilmentStrategy;
+    /** When `fulfilment_strategy = 'defined_order'`, the ordered list
+     *  of warehouse UUIDs to walk. */
+    fulfilmentStrategyWarehouseOrder;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Product.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 255 }),
+    Unique(),
+    __metadata("design:type", String)
+], Product.prototype, "sku", void 0);
+__decorate([
+    Property({ type: 'string', length: 160 }),
+    Index(),
+    Unique(),
+    __metadata("design:type", String)
+], Product.prototype, "slug", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], Product.prototype, "type", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    Index(),
+    __metadata("design:type", String)
+], Product.prototype, "status", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Object)
+], Product.prototype, "name", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Object)
+], Product.prototype, "description", void 0);
+__decorate([
+    Property({ type: 'string', length: 16, nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "stockMode", void 0);
+__decorate([
+    Property({ type: 'string', length: 32 }),
+    __metadata("design:type", String)
+], Product.prototype, "visibility", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Object)
+], Product.prototype, "attributeValues", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Array)
+], Product.prototype, "allowedOrganizationIds", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Product.prototype, "attributeSetId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "downloadAssetId", void 0);
+__decorate([
+    Property({ type: 'string', length: 2048, nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "downloadUrl", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    Index(),
+    __metadata("design:type", Date)
+], Product.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    Index(),
+    __metadata("design:type", Date)
+], Product.prototype, "updatedAt", void 0);
+__decorate([
+    Property({ type: 'datetime', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Product.prototype, "archivedAt", void 0);
+__decorate([
+    Property({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "deletedAt", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Product.prototype, "manageStock", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Product.prototype, "backorderEnabled", void 0);
+__decorate([
+    Property({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "lowStockThreshold", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], Product.prototype, "lowStockThresholdMode", void 0);
+__decorate([
+    Property({ type: 'string', length: 32, nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "fulfilmentStrategy", void 0);
+__decorate([
+    Property({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], Product.prototype, "fulfilmentStrategyWarehouseOrder", void 0);
+Product = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'products' })
+], Product);
+export { Product };
+//# sourceMappingURL=product.entity.js.map

package/dist/backend/entities/product.entity.js.map

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