react-shopwave-connect 0.4.6 → 0.4.7

package/dist/next/index.cjs

@@ -356,6 +356,27 @@ const SHOPWAVE_LOOKUPS = Object.freeze({
 * - employee: POST updates `roleId`, `joinedDate`, `exitDate` (names can't be
 *   changed); no DELETE (live API: "Cannot DELETE /employee") → retired via `exitDate`.
 * - consumer: read-only (`GET` with `ids`, comma-separated); live POST → 404.
+* - productComponent: modifier groups, `/product/component` (live, staging, 11 Nov 2026). The
+*   API reference lists no read filters; these are what the live API does:
+*   - Reads filter by `componentIds` (group ids) or `productIds` (the parent product; option
+*     products don't match). `productComponentIds` is ignored on reads: every group comes back.
+*     `deleted: false` gives live groups only, `true` deleted groups only, no header both.
+*     No match → 204 with an empty body. No order, sort, priority or position field anywhere.
+*   - Groups are keyed by id; `products` (option products) by product id; `productInstances`
+*     (option rows) by row id. Reads reformat values: price `"100"` → `"100.0"`,
+*     vatPercentage `"0.2000"` → `"0.200"`. `tags` and `name` are stored as sent (no trimming;
+*     a `tags` array is joined with commas; `tags` null or left out → null).
+*   - POST upserts (201, echoed under the ref). For each option product in `products`, its rows
+*     are replaced: every row sent is created afresh with a new id (a row `id` is ignored, also
+*     on a price change) and rows left out are removed. Option products left out of the save
+*     are untouched, and an empty `productInstances` removes nothing. A save without `products`
+*     updates only the group's own fields. The echo isn't proof of what was stored: renames of
+*     groups created moments earlier by a test run echoed the new name but never stuck (re-read
+*     for 90 s), while older groups, and groups created in Shopwave's own admin, renamed at
+*     once. Cause not yet known.
+*   - DELETE with `productComponentIds` (plural, comma list) → 205, soft delete. Adding
+*     `productComponentInstanceIds` deletes just those rows (205); they stay in live reads with
+*     `deleteDate` set. The singular `productComponentId` hangs (504 after 60 s).
 */
 const SHOPWAVE_ENTITIES = Object.freeze({
 	product: {
@@ -415,6 +436,16 @@ const SHOPWAVE_ENTITIES = Object.freeze({
 		idHeader: "consumerId",
 		writable: false,
 		deleteMode: "none"
+	},
+	productComponent: {
+		route: "product-components",
+		collection: "productComponents",
+		upstream: "product/component",
+		idsHeader: "componentIds",
+		idHeader: "productComponentIds",
+		writable: true,
+		deleteMode: "delete",
+		childIdsHeader: "productComponentInstanceIds"
 	}
 });
 
@@ -588,6 +619,29 @@ async function readUpstream(response) {
 		};
 	}
 }
+/**
+* The child ids a DELETE names in `extras` under `header` (case-insensitive), as one comma
+* list: `undefined` when the key is absent, `null` when `extras` or the value is invalid (not a
+* JSON object, or not a non-empty list of ids). The key may hold an array or a comma string.
+*/
+function readChildIds(raw, header) {
+	if (!raw) return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return null;
+	}
+	if (!isPlainObject(parsed)) return null;
+	const key = Object.keys(parsed).find((k) => k.toLowerCase() === header.toLowerCase());
+	if (key === void 0) return void 0;
+	const value = parsed[key];
+	const list = Array.isArray(value) ? value : typeof value === "string" || typeof value === "number" ? String(value).split(",") : null;
+	if (!list) return null;
+	const ids = list.map((v) => typeof v === "string" || typeof v === "number" ? String(v).trim() : "");
+	if (ids.length === 0 || ids.some((id) => !ID_PATTERN.test(id))) return null;
+	return ids.join(",");
+}
 async function routeParam(context, name) {
 	const value = (await context?.params)?.[name];
 	const id = Array.isArray(value) ? value[0] : value;
@@ -838,6 +892,19 @@ function createShopwaveApiHandlers(config) {
 					const id = await routeParam(context, param);
 					if (!id) return badId();
 					if (def.deleteMode === "none") return notSupported(def, "deletes");
+					if (def.deleteMode === "delete" && def.childIdsHeader) {
+						const childIds = readChildIds(request.headers.get("extras"), def.childIdsHeader);
+						if (childIds === null) return jsonError(400, "invalid_extras", `"${def.childIdsHeader}" must be a non-empty list of ids`);
+						if (childIds !== void 0) return forward(request, {
+							method: "DELETE",
+							path: def.upstream,
+							headers: {
+								[def.idHeader]: id,
+								[def.childIdsHeader]: childIds
+							},
+							forwardExtras: false
+						});
+					}
 					if (def.deleteMode === "retire") {
 						const field = def.retireField ?? "exitDate";
 						if (def.retireWithRecord) return retireWithRecord(request, def, id, field);