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

package/CHANGELOG.md

@@ -3,6 +3,82 @@
 All notable changes to `@propeller-commerce/propeller-sdk-v2` are documented here.
 
 ---
+## [0.18.0] - 2026-09-24
+
+`product` and `cluster` can now be scoped to a contact and a company, so a
+storefront can ask the assortment question the API was always able to answer.
+
+### Added
+
+- **`userId` and `companyId` on the `product` and `cluster` queries.** Both
+  arguments have always existed on the schema — the generated operations simply
+  did not declare or forward them, so there was no way to reach them through the
+  SDK and every call resolved against the bearer token's own identity.
+
+  This is what left a direct link to a product outside the company's POSITIVE
+  orderlist opening normally while listings and search correctly hid it: the
+  listing queries scope by identity, the single-entity ones could not. With the
+  arguments in place, `product(productId:, userId:, companyId:)` answers
+  `PRODUCT_NOT_FOUND` for a product outside the contact's assortment, which is
+  the correct answer and what a host needs in order to 404 the page. (PWP-1015)
+
+  Both are optional and default to undefined, so every existing call is
+  unchanged.
+
+### Notes for consumers
+
+- The API rejects a `companyId` the contact does not belong to ("Unauthorized
+  use of companyId"), so a company restored from storage must be validated
+  against the contact's companies before it is sent.
+- Three adjacent gaps were found while checking this and are deliberately NOT
+  in this release, because each is a behaviour change rather than an additive
+  argument: `product`/`cluster` also accept `hidden`, `clusterConfig` forwards
+  only `clusterId` (so it is not identity-scoped either), and
+  `orderGetPDF`/`quoteGetPDF` accept a `revisionNumber`. Say the word and they
+  can go in one follow-up rather than three.
+
+---
+
+
+## [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
 

package/dist/cjs/generated/operationVariables.d.ts

@@ -1798,6 +1798,8 @@ export interface ClusterVariables {
     language?: string;
     applyOrderlists?: boolean;
     orderlistIds?: number[];
+    userId?: number;
+    companyId?: number;
     priceCalculateProductInput?: PriceCalculateProductInput;
     userBulkPriceProductInput?: UserBulkPriceProductInput;
     attributeResultSearchInput?: AttributeResultSearchInput;
@@ -3820,6 +3822,8 @@ export interface ProductVariables {
     language?: string;
     applyOrderlists?: boolean;
     orderlistIds?: number[];
+    userId?: number;
+    companyId?: number;
     priceCalculateProductInput?: PriceCalculateProductInput;
     userBulkPriceProductInput?: UserBulkPriceProductInput;
     attributeResultSearchInput?: AttributeResultSearchInput;

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

@@ -842,13 +842,15 @@ fragment ClusterConfigSettingFields on ClusterConfigSetting {
   priority
 }
 
-query cluster(\$clusterId: Int, \$slug: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
+query cluster(\$clusterId: Int, \$slug: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$userId: Int, \$companyId: Int, \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
   cluster(
     clusterId: \$clusterId
     slug: \$slug
     language: \$language
     applyOrderlists: \$applyOrderlists
     orderlistIds: \$orderlistIds
+    userId: \$userId
+    companyId: \$companyId
   ) {
     ...ClusterFields
   }

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/generated/operations/product.js

@@ -712,7 +712,7 @@ fragment SurchargeFields on Surcharge {
   validTo
 }
 
-query product(\$productId: Int, \$slug: String, \$sku: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
+query product(\$productId: Int, \$slug: String, \$sku: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$userId: Int, \$companyId: Int, \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
   product(
     productId: \$productId
     slug: \$slug
@@ -720,6 +720,8 @@ query product(\$productId: Int, \$slug: String, \$sku: String, \$language: Strin
     language: \$language
     applyOrderlists: \$applyOrderlists
     orderlistIds: \$orderlistIds
+    userId: \$userId
+    companyId: \$companyId
   ) {
     ...ProductFields
   }

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/cluster.js

@@ -839,13 +839,15 @@ fragment ClusterConfigSettingFields on ClusterConfigSetting {
   priority
 }
 
-query cluster(\$clusterId: Int, \$slug: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
+query cluster(\$clusterId: Int, \$slug: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$userId: Int, \$companyId: Int, \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
   cluster(
     clusterId: \$clusterId
     slug: \$slug
     language: \$language
     applyOrderlists: \$applyOrderlists
     orderlistIds: \$orderlistIds
+    userId: \$userId
+    companyId: \$companyId
   ) {
     ...ClusterFields
   }

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/dist/esm/generated/operations/product.js

@@ -709,7 +709,7 @@ fragment SurchargeFields on Surcharge {
   validTo
 }
 
-query product(\$productId: Int, \$slug: String, \$sku: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
+query product(\$productId: Int, \$slug: String, \$sku: String, \$language: String, \$applyOrderlists: Boolean, \$orderlistIds: [Int!], \$userId: Int, \$companyId: Int, \$priceCalculateProductInput: PriceCalculateProductInput, \$userBulkPriceProductInput: UserBulkPriceProductInput, \$attributeResultSearchInput: AttributeResultSearchInput, \$imageSearchFilters: MediaImageProductSearchInput, \$mediaVideoSearchInput: MediaVideoProductSearchInput, \$mediaDocumentSearchInput: MediaDocumentProductSearchInput, \$imageVariantFilters: TransformationsInput!) {
   product(
     productId: \$productId
     slug: \$slug
@@ -717,6 +717,8 @@ query product(\$productId: Int, \$slug: String, \$sku: String, \$language: Strin
     language: \$language
     applyOrderlists: \$applyOrderlists
     orderlistIds: \$orderlistIds
+    userId: \$userId
+    companyId: \$companyId
   ) {
     ...ProductFields
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@propeller-commerce/propeller-sdk-v2",
-  "version": "0.16.0",
+  "version": "0.18.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",