react-shopwave-connect 0.4.1 → 0.4.3

package/dist/next/index.cjs

@@ -281,7 +281,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.
@@ -322,7 +325,9 @@ const SHOPWAVE_ENTITIES = Object.freeze({
 		idHeader: "promotionId",
 		writable: true,
 		deleteMode: "retire",
-		retireField: "endDate"
+		retireField: "endDate",
+		retireWithRecord: true,
+		retireStartField: "startDate"
 	},
 	employee: {
 		route: "employees",
@@ -388,6 +393,18 @@ const SHOPWAVE_UPLOAD = Object.freeze({
 function isUploadKind(value) {
 	return typeof value === "string" && Object.prototype.hasOwnProperty.call(UPLOAD_KINDS, value);
 }
+const SHOPWAVE_LOOKUPS = Object.freeze({
+	productTags: {
+		route: "products/tags",
+		key: "tags",
+		upstream: "product/tags"
+	},
+	productInstanceTags: {
+		route: "products/instance-tags",
+		key: "tags",
+		upstream: "product/instance/tags"
+	}
+});
 
 //#endregion
 //#region src/server/api.ts
@@ -521,6 +538,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,
@@ -720,6 +749,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,
@@ -755,6 +823,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,
@@ -777,6 +846,14 @@ function createShopwaveApiHandlers(config) {
 		passthrough(path) {
 			return { GET: (request) => forward(request, { path }) };
 		},
+		lookup(kind) {
+			const def = SHOPWAVE_LOOKUPS[kind];
+			if (!def) throw new Error(`Unknown Shopwave lookup "${kind}"`);
+			return { GET: (request) => forward(request, {
+				path: def.upstream,
+				forwardExtras: false
+			}) };
+		},
 		resource(kind) {
 			const def = resourceDef(kind);
 			const save = (request) => writeResource(request, def);
@@ -1119,6 +1196,9 @@ function createShopwaveAuth(config) {
 * export const { GET } = shopwave.resource("user");
 * // app/api/upload/route.ts
 * export const { POST } = shopwave.upload();
+* // app/api/products/tags/route.ts, app/api/products/instance-tags/route.ts
+* export const { GET } = shopwave.lookup("productTags");
+* export const { GET } = shopwave.lookup("productInstanceTags");
 * ```
 */
 function createShopwaveApi(config) {
@@ -1132,6 +1212,7 @@ function createShopwaveApi(config) {
 
 //#endregion
 exports.SHOPWAVE_ENTITIES = SHOPWAVE_ENTITIES;
+exports.SHOPWAVE_LOOKUPS = SHOPWAVE_LOOKUPS;
 exports.SHOPWAVE_RESOURCES = SHOPWAVE_RESOURCES;
 exports.ShopwaveAuthError = ShopwaveAuthError;
 exports.UPLOAD_KINDS = UPLOAD_KINDS;