@propeller-commerce/propeller-sdk-v2 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -4,6 +4,46 @@ All notable changes to `@propeller-commerce/propeller-sdk-v2` are documented her
 
 ---
 
+## [0.17.0] - 2026-09-23
+
+Spare-parts machine fields come back in every language the tenant authored,
+instead of only the one the query asked for.
+
+### Changed
+
+- **`SparePartsMachineMinimalFields` no longer passes `(language: $language)`
+  to `name`, `description` and `slug`.** The field argument narrowed each of
+  them to a single language, which defeated the cross-language fallback every
+  consumer implements (`getLocalizedValue` returns the first non-empty entry).
+  A machine authored without a slug in the tree language came back with an
+  empty `slug`, the UI could not build an href, and the row was dropped from
+  the list entirely — a customer saw three of four machines with nothing saying
+  so (PWP-993).
+
+  The query-level `machine(… language: $language)` argument is untouched: it
+  still selects the tree. Only the per-node localized fields widen.
+
+  Affects `machine`, `machines`, `machineCreate` and `machineUpsert`. All four
+  keep `$language` — `MediaImageFields.alt(language: $language)` still
+  references it — so no operation is left with an unused variable.
+
+  **Consumers that assumed `name[0]` is the requested language must resolve by
+  language instead.** `getLocalizedValue` / `getLanguageString` in core-ui
+  already do, so react-ui and vue-ui needed no change.
+
+  Verified against a tenant whose machines are authored EN-only, where both
+  forms return one entry; the multilingual path follows the behaviour recorded
+  in PWP-1010(b) and still wants confirming on a multilingual tenant.
+
+### Documentation
+
+- **`sum` / `sumNet` on `CartMainItem`, `CartBaseItem` and `TenderMainItem` now
+  lead with the warning that they are PER UOM, not line totals**, and point at
+  `totalSum` / `totalSumNet`. The description was always accurate but the name
+  reads like a line total, so `items.reduce((a, l) => a + l.sum, 0)` looks
+  right, compiles green, and returns a number that is wrong by a factor of the
+  quantity — a 30-piece line at €15.09 produced €15.09 (PWP-1006).
+
 ## [0.16.0] - 2026-08-04
 
 Puts product attributes on the grid. `ProductGridFields` now selects a lean

package/dist/cjs/generated/operations/machine.js

@@ -17,13 +17,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/cjs/generated/operations/machineCreate.js

@@ -17,13 +17,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/cjs/generated/operations/machineUpsert.js

@@ -17,13 +17,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/cjs/generated/operations/machines.js

@@ -29,13 +29,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/cjs/type/CartBaseItem.d.ts

@@ -24,9 +24,20 @@ export interface CartBaseItem extends ICartBaseItem {
     totalPrice: number;
     /** Total net price for this cart item, including item specific discounts. */
     totalPriceNet: number;
-    /** Gross sum of the main cart price and the prices of its child items per UOM. No item specific discounts are applied to this price. */
+    /**
+     * PER UOM, *not* the line total — despite the name. Gross sum of the main
+     * price and the prices of its child items, for ONE unit, with no item
+     * specific discounts applied.
+     *
+     * For the line total use {@link totalSum}. Summing `sum` across a cart
+     * under-reports every line by a factor of its quantity, and does it silently:
+     * the result is a plausible number and the types are green.
+     */
     sum: number;
-    /** Net sum of the main cart price and the prices of its child items per UOM. No item specific discounts are applied to this price. */
+    /**
+     * PER UOM, *not* the line total — see {@link sum}. For the line total use
+     * {@link totalSumNet}.
+     */
     sumNet: number;
     /** Total gross sum of the main cart price and the prices of its child items. Including item specific discounts. */
     totalSum: number;

package/dist/cjs/type/CartMainItem.d.ts

@@ -32,9 +32,20 @@ export interface CartMainItem extends ICartBaseItem {
     totalPrice: number;
     /** Total net price for this cart item, including item specific discounts. */
     totalPriceNet: number;
-    /** Gross sum of the main cart price and the prices of its child items per UOM. No item specific discounts are applied to this price. */
+    /**
+     * PER UOM, *not* the line total — despite the name. Gross sum of the main
+     * price and the prices of its child items, for ONE unit, with no item
+     * specific discounts applied.
+     *
+     * For the line total use {@link totalSum}. Summing `sum` across a cart
+     * under-reports every line by a factor of its quantity, and does it silently:
+     * the result is a plausible number and the types are green.
+     */
     sum: number;
-    /** Net sum of the main cart price and the prices of its child items per UOM. No item specific discounts are applied to this price. */
+    /**
+     * PER UOM, *not* the line total — see {@link sum}. For the line total use
+     * {@link totalSumNet}.
+     */
     sumNet: number;
     /** Total gross sum of the main cart price and the prices of its child items. Including item specific discounts. */
     totalSum: number;

package/dist/cjs/type/TenderMainItem.d.ts

@@ -75,9 +75,20 @@ export interface TenderMainItem extends ITenderBaseItem {
     surcharges?: TenderItemSurcharge[];
     /** The tender/order item's child items. E.g. surcharges, incentives, etc. */
     childItems?: ITenderBaseItem[];
-    /** The gross price per UOM of this tender/order item, with item specific incentives and extra costs applied to this price. VAT excluding */
+    /**
+     * PER UOM, *not* the line total — despite the name. The gross price for ONE
+     * unit of this tender/order item, with item specific incentives and extra
+     * costs applied. VAT EXCLUDING (this API labels the ex-VAT figure "gross").
+     *
+     * For the line total use {@link totalSum}. Summing `sum` across the items
+     * under-reports every line by a factor of its quantity, and does it silently:
+     * the result is a plausible number and the types are green (PWP-1006).
+     */
     sum: number;
-    /** The price per UOM of this tender/order item, with item specific incentives and extra costs applied to this price. VAT including */
+    /**
+     * PER UOM, *not* the line total — see {@link sum}. VAT INCLUDING. For the
+     * line total use {@link totalSumNet}.
+     */
     sumNet: number;
     /** The total gross price of this tender/order item, with item specific incentives and extra costs applied to this price. VAT excluding */
     totalSum: number;

package/dist/esm/generated/operations/machine.js

@@ -14,13 +14,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/esm/generated/operations/machineCreate.js

@@ -14,13 +14,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/esm/generated/operations/machineUpsert.js

@@ -14,13 +14,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/dist/esm/generated/operations/machines.js

@@ -26,13 +26,13 @@ fragment SparePartsMachineMinimalFields on SparePartsMachine {
   media {
     ...SparePartsMachineMediaImagesOnlyFields
   }
-  name(language: \$language) {
+  name {
     ...LocalizedStringFields
   }
-  description(language: \$language) {
+  description {
     ...LocalizedStringFields
   }
-  slug(language: \$language) {
+  slug {
     ...LocalizedStringFields
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@propeller-commerce/propeller-sdk-v2",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "TypeScript GraphQL client for Propeller eCommerce V2 Platform - works with React, Vue, Angular and all JavaScript frameworks",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",