react-shopwave-connect 0.4.1 → 0.4.3

package/dist/hooks/index.d.cts

@@ -546,6 +546,26 @@ declare function useEmployee(params?: FetchEmployeesParams, options?: RequestOpt
  */
 declare function useProduct(params?: FetchProductsParams, options?: RequestOptions): QueryState<Product[]>;
 //#endregion
+//#region src/hooks/useProductTags.d.ts
+type LookupOptions = RequestOptions & {
+  /** Fetch only when true (e.g. once a tag field is first opened). Defaults to true. */
+  enabled?: boolean;
+};
+/**
+ * The merchant's distinct product tags, for a tag field's suggestions.
+ * `data` is `string[]` once loaded.
+ *
+ * @example
+ * const [opened, setOpened] = useState(false);
+ * const { data: tags, loading } = useProductTags({ enabled: opened });
+ */
+declare function useProductTags(options?: LookupOptions): QueryState<string[]>;
+/**
+ * The merchant's distinct price-instance (channel) tags: Eat In, Takeout, …
+ * `data` is `string[]` once loaded.
+ */
+declare function useProductInstanceTags(options?: LookupOptions): QueryState<string[]>;
+//#endregion
 //#region src/hooks/usePromotion.d.ts
 /**
  * Auto-fetches promotions on mount and whenever the params change.
@@ -699,5 +719,5 @@ interface UseBasketReportReturn {
  */
 declare function useBasketReport(options?: RequestOptions): UseBasketReportReturn;
 //#endregion
-export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
+export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
 //# sourceMappingURL=index.d.cts.map

package/dist/hooks/index.d.ts

@@ -546,6 +546,26 @@ declare function useEmployee(params?: FetchEmployeesParams, options?: RequestOpt
  */
 declare function useProduct(params?: FetchProductsParams, options?: RequestOptions): QueryState<Product[]>;
 //#endregion
+//#region src/hooks/useProductTags.d.ts
+type LookupOptions = RequestOptions & {
+  /** Fetch only when true (e.g. once a tag field is first opened). Defaults to true. */
+  enabled?: boolean;
+};
+/**
+ * The merchant's distinct product tags, for a tag field's suggestions.
+ * `data` is `string[]` once loaded.
+ *
+ * @example
+ * const [opened, setOpened] = useState(false);
+ * const { data: tags, loading } = useProductTags({ enabled: opened });
+ */
+declare function useProductTags(options?: LookupOptions): QueryState<string[]>;
+/**
+ * The merchant's distinct price-instance (channel) tags: Eat In, Takeout, …
+ * `data` is `string[]` once loaded.
+ */
+declare function useProductInstanceTags(options?: LookupOptions): QueryState<string[]>;
+//#endregion
 //#region src/hooks/usePromotion.d.ts
 /**
  * Auto-fetches promotions on mount and whenever the params change.
@@ -699,5 +719,5 @@ interface UseBasketReportReturn {
  */
 declare function useBasketReport(options?: RequestOptions): UseBasketReportReturn;
 //#endregion
-export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
+export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.js

@@ -259,6 +259,106 @@ async function fetchProductsMap(productIds, options = {}, batchSize = 200) {
 	return result;
 }
 
+//#endregion
+//#region src/core/resources.ts
+/**
+* - merchant: `GET /merchant`; `POST /merchant` with `{ merchant: { id, … } }`
+*   updates it (without an `id` the API would create a second merchant, so the
+*   route requires one).
+* - user: `GET /user` (read-only here; the API's `POST /user` invites users and
+*   needs the admin scope).
+*/
+const SHOPWAVE_RESOURCES = Object.freeze({
+	merchant: {
+		route: "merchant",
+		key: "merchant",
+		upstream: "merchant",
+		writable: true
+	},
+	user: {
+		route: "user",
+		key: "user",
+		upstream: "user",
+		writable: false
+	}
+});
+/** `UploadKind` → the API's `contentType` value. */
+const UPLOAD_KINDS = Object.freeze({
+	merchant: "merchant",
+	merchantFeature: "merchantFeature",
+	product: "product",
+	user: "user",
+	applicationLogo: "applicaionLogo",
+	applicationImages: "applicaionImages"
+});
+/** How uploads are addressed (app route and Shopwave uploader). */
+const SHOPWAVE_UPLOAD = Object.freeze({
+	route: "upload",
+	upstream: "uploader",
+	kindHeader: "contentType",
+	fileField: "file",
+	kindField: "kind"
+});
+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/core/productTags.ts
+/**
+* Turns a tag list from the API into clean strings: trims each tag, drops
+* blanks and anything that isn't text, and removes exact duplicates (first one
+* wins). The API's own order is kept. A map is accepted too (its values are
+* used), in case the API ever answers keyed by id.
+*/
+function normalizeTagList(value) {
+	const list = Array.isArray(value) ? value : value && typeof value === "object" ? Object.values(value) : [];
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const item of list) {
+		if (typeof item !== "string" && typeof item !== "number") continue;
+		const tag = String(item).trim();
+		if (!tag || seen.has(tag)) continue;
+		seen.add(tag);
+		out.push(tag);
+	}
+	return out;
+}
+async function fetchLookup(kind, options) {
+	const def = SHOPWAVE_LOOKUPS[kind];
+	if (!def) throw new Error(`Unknown Shopwave lookup "${kind}"`);
+	const json = await apiGet(`/api/${def.route}`, {}, options);
+	assertNoApiErrors(json, 200);
+	return normalizeTagList(json?.[def.key]);
+}
+/**
+* Every distinct tag used on the merchant's products (`GET /product/tags`),
+* for a tag field's suggestions. Returns `[]` when there are none.
+*/
+function fetchProductTags(options = {}) {
+	return fetchLookup("productTags", options);
+}
+/**
+* Every distinct tag used on the merchant's price instances
+* (`GET /product/instance/tags`): the channel names (Eat In, Takeout, …).
+* Returns `[]` when there are none.
+*/
+function fetchProductInstanceTags(options = {}) {
+	return fetchLookup("productInstanceTags", options);
+}
+
 //#endregion
 //#region src/core/promotion.ts
 /**
@@ -512,50 +612,6 @@ function buildConsumerMap(consumers) {
 	return map;
 }
 
-//#endregion
-//#region src/core/resources.ts
-/**
-* - merchant: `GET /merchant`; `POST /merchant` with `{ merchant: { id, … } }`
-*   updates it (without an `id` the API would create a second merchant, so the
-*   route requires one).
-* - user: `GET /user` (read-only here; the API's `POST /user` invites users and
-*   needs the admin scope).
-*/
-const SHOPWAVE_RESOURCES = Object.freeze({
-	merchant: {
-		route: "merchant",
-		key: "merchant",
-		upstream: "merchant",
-		writable: true
-	},
-	user: {
-		route: "user",
-		key: "user",
-		upstream: "user",
-		writable: false
-	}
-});
-/** `UploadKind` → the API's `contentType` value. */
-const UPLOAD_KINDS = Object.freeze({
-	merchant: "merchant",
-	merchantFeature: "merchantFeature",
-	product: "product",
-	user: "user",
-	applicationLogo: "applicaionLogo",
-	applicationImages: "applicaionImages"
-});
-/** How uploads are addressed (app route and Shopwave uploader). */
-const SHOPWAVE_UPLOAD = Object.freeze({
-	route: "upload",
-	upstream: "uploader",
-	kindHeader: "contentType",
-	fileField: "file",
-	kindField: "kind"
-});
-function isUploadKind(value) {
-	return typeof value === "string" && Object.prototype.hasOwnProperty.call(UPLOAD_KINDS, value);
-}
-
 //#endregion
 //#region src/core/imageFit.ts
 /**
@@ -1100,6 +1156,33 @@ function useProduct(params = {}, options) {
 	]);
 }
 
+//#endregion
+//#region src/hooks/useProductTags.ts
+/**
+* The merchant's distinct product tags, for a tag field's suggestions.
+* `data` is `string[]` once loaded.
+*
+* @example
+* const [opened, setOpened] = useState(false);
+* const { data: tags, loading } = useProductTags({ enabled: opened });
+*/
+function useProductTags(options) {
+	return useQuery((signal) => fetchProductTags({
+		...options,
+		signal
+	}), [options?.baseUrl, options?.token], options?.enabled ?? true);
+}
+/**
+* The merchant's distinct price-instance (channel) tags: Eat In, Takeout, …
+* `data` is `string[]` once loaded.
+*/
+function useProductInstanceTags(options) {
+	return useQuery((signal) => fetchProductInstanceTags({
+		...options,
+		signal
+	}), [options?.baseUrl, options?.token], options?.enabled ?? true);
+}
+
 //#endregion
 //#region src/hooks/usePromotion.ts
 /**
@@ -1410,5 +1493,5 @@ function useBasketReport(options) {
 }
 
 //#endregion
-export { useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
+export { useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
 //# sourceMappingURL=index.js.map