react-shopwave-connect 0.4.1 → 0.4.2

package/dist/next/index.d.ts

@@ -106,13 +106,25 @@ interface EntityDefinition {
   /**
    * How a delete is done upstream:
    * - `"delete"`: `DELETE {apiUrl}/<upstream>` with the `idHeader` (205, empty body)
-   * - `"retire"`: the API has no DELETE; the record is retired by POSTing
-   *   `{ id, [retireField]: <now> }` (employees: `exitDate`, promotions: `endDate`)
+   * - `"retire"`: the API has no DELETE; the record is retired by setting
+   *   `retireField` to now (employees: `exitDate`, promotions: `endDate`)
    * - `"none"`: can't be deleted
    */
   deleteMode: "delete" | "retire" | "none";
   /** Date field set to "now" when `deleteMode` is `"retire"`. */
   retireField?: string;
+  /**
+   * Retire by reading the record and POSTing all of it back with the date(s)
+   * changed, instead of a partial `{ id, [retireField]: <now> }`. Needed where
+   * the API rejects a partial save (promotions: error 899, live 14 Oct 2026).
+   */
+  retireWithRecord?: boolean;
+  /**
+   * Start-date field of a record retired with `retireWithRecord`. If the record
+   * hasn't started yet (start after now), the start moves to now as well, so
+   * start = end and the record is expired without ever running.
+   */
+  retireStartField?: string;
 }
 type EntityKind = "product" | "category" | "store" | "promotion" | "employee" | "consumer";
 /**
@@ -120,7 +132,10 @@ type EntityKind = "product" | "category" | "store" | "promotion" | "employee" |
  * (https://developer.merchantstack.com/api-reference.html) and checked against
  * the live API where noted:
  * - category/product/store: GET filtered by `<x>Ids`, POST upsert, DELETE with `<x>Id` → 205.
- * - promotion: no DELETE; "deleting" a promotion ends it by setting `endDate` to now.
+ * - promotion: no DELETE; promotions are never deleted, only expired. Expiring
+ *   reads the promotion and saves the whole record back with `endDate` = now (and
+ *   `startDate` = now too if it hadn't started); the live API rejects a partial
+ *   `{ id, endDate }` save with error 899. Dates are UTC `YYYY-MM-DD HH:mm:ss`.
  * - 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.

package/dist/next/index.js

@@ -255,7 +255,10 @@ function safeEqual(a, b) {
 * (https://developer.merchantstack.com/api-reference.html) and checked against
 * the live API where noted:
 * - category/product/store: GET filtered by `<x>Ids`, POST upsert, DELETE with `<x>Id` → 205.
-* - promotion: no DELETE; "deleting" a promotion ends it by setting `endDate` to now.
+* - promotion: no DELETE; promotions are never deleted, only expired. Expiring
+*   reads the promotion and saves the whole record back with `endDate` = now (and
+*   `startDate` = now too if it hadn't started); the live API rejects a partial
+*   `{ id, endDate }` save with error 899. Dates are UTC `YYYY-MM-DD HH:mm:ss`.
 * - 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.
@@ -296,7 +299,9 @@ const SHOPWAVE_ENTITIES = Object.freeze({
 		idHeader: "promotionId",
 		writable: true,
 		deleteMode: "retire",
-		retireField: "endDate"
+		retireField: "endDate",
+		retireWithRecord: true,
+		retireStartField: "startDate"
 	},
 	employee: {
 		route: "employees",
@@ -495,6 +500,18 @@ function jsonError(status, error, message) {
 function shopwaveDateTime(date = /* @__PURE__ */ new Date()) {
 	return date.toISOString().slice(0, 19).replace("T", " ");
 }
+/**
+* Reads a Shopwave datetime: ISO with a zone (what reads return, e.g.
+* `2026-10-20T16:00:00.000Z`) or a zoneless `YYYY-MM-DD HH:mm:ss`, which is UTC.
+* `null` when the value isn't a date.
+*/
+function parseShopwaveDateTime(value) {
+	if (typeof value !== "string" || !value.trim()) return null;
+	const text = value.trim();
+	const zoneless = /^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/.test(text);
+	const date = new Date(zoneless ? `${text.replace(" ", "T")}Z` : text);
+	return Number.isNaN(date.getTime()) ? null : date;
+}
 const NULL_BODY_STATUS = new Set([
 	101,
 	103,
@@ -694,6 +711,45 @@ function createShopwaveApiHandlers(config) {
 	function badId() {
 		return jsonError(400, "invalid_id", "Missing or invalid id");
 	}
+	/**
+	* Retires a record the API won't take a partial save for (promotions): reads it,
+	* sets `field` to now (and `def.retireStartField` to now too when the record
+	* hasn't started yet), and POSTs the whole record back. Both dates are sent as
+	* UTC `YYYY-MM-DD HH:mm:ss`; reads return them as ISO with `Z`.
+	*/
+	async function retireWithRecord(request, def, id, field) {
+		const read = await forward(request, {
+			path: def.upstream,
+			headers: { [def.idsHeader]: id },
+			forwardExtras: false
+		});
+		if (!read.ok) return read;
+		let body;
+		try {
+			body = await read.json();
+		} catch {
+			return jsonError(502, "invalid_upstream", `The Shopwave API's ${def.upstream} read wasn't JSON`);
+		}
+		const map = isPlainObject(body) && isPlainObject(body[def.collection]) ? body[def.collection] : {};
+		const record = Object.values(map).find((entry) => isPlainObject(entry) && String(entry.id) === id);
+		if (!record) return jsonError(404, "not_found", `No ${def.upstream} with id ${id}`);
+		const now = /* @__PURE__ */ new Date();
+		const retired = {
+			...record,
+			[field]: shopwaveDateTime(now)
+		};
+		const startField = def.retireStartField;
+		if (startField) {
+			const start = parseShopwaveDateTime(record[startField]);
+			if (start) retired[startField] = shopwaveDateTime(start > now ? now : start);
+		}
+		return forward(request, {
+			method: "POST",
+			path: def.upstream,
+			postBody: { [def.collection]: { 0: retired } },
+			forwardExtras: false
+		});
+	}
 	return {
 		forward,
 		entity,
@@ -729,6 +785,7 @@ function createShopwaveApiHandlers(config) {
 					if (def.deleteMode === "none") return notSupported(def, "deletes");
 					if (def.deleteMode === "retire") {
 						const field = def.retireField ?? "exitDate";
+						if (def.retireWithRecord) return retireWithRecord(request, def, id, field);
 						return forward(request, {
 							method: "POST",
 							path: def.upstream,