react-shopwave-connect 0.4.6 → 0.4.7

package/dist/hooks/index.d.cts

@@ -183,6 +183,32 @@ interface FetchProductsParams {
   token?: string;
 }
 //#endregion
+//#region src/core/store.d.ts
+interface Store {
+  id: number;
+  lat: number;
+  lng: number;
+  addressLine1: string;
+  addressLine2: string | null;
+  addressLine3: string;
+  phoneNumber: string;
+  city: string;
+  postcode: string;
+  countryId: number | null;
+  timezoneId: number | null;
+  storeDeleteDate: string | null;
+  email: string | null;
+  sandbox: boolean | null;
+}
+interface FetchStoresParams {
+  /** Optional id filter. */
+  storeIds?: Array<number>;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+  /** @deprecated Pass `options.token` instead. Sent the same way (Authorization header). */
+  token?: string;
+}
+//#endregion
 //#region src/core/promotion.d.ts
 /** Promotion rule identifiers as stored by the Shopwave API. */
 declare enum PromotionRuleSet {
@@ -226,30 +252,62 @@ interface FetchPromotionsParams {
   token?: string;
 }
 //#endregion
-//#region src/core/store.d.ts
-interface Store {
+//#region src/core/productComponent.d.ts
+/**
+ * Product components are modifier groups: a group belongs to a parent product
+ * (`productId`) and offers other products as options. Each option product has
+ * one or more option rows (`productInstances`). See `SHOPWAVE_ENTITIES.productComponent`
+ * for what the live API does on reads, saves and deletes.
+ */
+/** One option row of a product component. */
+interface ProductComponentInstance {
   id: number;
-  lat: number;
-  lng: number;
-  addressLine1: string;
-  addressLine2: string | null;
-  addressLine3: string;
-  phoneNumber: string;
-  city: string;
-  postcode: string;
-  countryId: number | null;
-  timezoneId: number | null;
-  storeDeleteDate: string | null;
-  email: string | null;
-  sandbox: boolean | null;
-}
-interface FetchStoresParams {
-  /** Optional id filter. */
-  storeIds?: Array<number>;
-  /** Whether to include soft-deleted records. Defaults to `false`. */
+  /** Name override for the option; `null` or `""` means the product's own name. Stored as sent. */
+  name: string | null;
+  /** Price as a decimal string, pence excluding VAT (reads return `"100.0"` for `"100"`). */
+  price: string;
+  /** VAT as a fraction string (`"0.200"`). */
+  vatPercentage: string;
+  quantity: number;
+  /** Comma-separated price tags, or `null`. Stored as sent (not trimmed). */
+  tags: string | null;
+  size?: string | null;
+  activeDate?: string | null;
+  /** Set once the row has been deleted; deleted rows still appear in live reads. */
+  deleteDate?: string | null;
+}
+/** A product offered as an option in a product component, with its option rows. */
+interface ProductComponentProduct {
+  id: number;
+  name: string;
+  barcode?: string | null;
+  details?: string | null;
+  unit?: number | null;
+  activeDate?: string | null;
+  /** Option rows, keyed by row id on reads. */
+  productInstances: Record<string, ProductComponentInstance>;
+}
+/** A product component (modifier group). */
+interface ProductComponent {
+  id: number;
+  name: string;
+  /** The parent product the group belongs to. */
+  productId: number;
+  minQuantity: number;
+  maxQuantity: number;
+  productTimestamp?: string;
+  /** Set once the group has been deleted (only `deleted: true` reads return it then). */
+  deleteDate?: string | null;
+  /** Option products, keyed by product id. */
+  products: Record<string, ProductComponentProduct>;
+}
+interface FetchProductComponentsParams {
+  /** Parent products whose groups to read. */
+  productIds?: ReadonlyArray<number | string>;
+  /** Groups to read, by id. */
+  productComponentIds?: ReadonlyArray<number | string>;
+  /** `false` (default): live groups only. `true`: deleted groups only. */
   deleted?: boolean;
-  /** @deprecated Pass `options.token` instead. Sent the same way (Authorization header). */
-  token?: string;
 }
 //#endregion
 //#region src/core/report.d.ts
@@ -585,6 +643,15 @@ declare function useProductTags(options?: LookupOptions): QueryState<string[]>;
  */
 declare function useProductInstanceTags(options?: LookupOptions): QueryState<string[]>;
 //#endregion
+//#region src/hooks/useProductComponent.d.ts
+/**
+ * Auto-fetches product components (modifier groups) on mount and whenever the params change:
+ * a product's groups with `{ productIds: [id] }`, one group with `{ productComponentIds: [id] }`,
+ * or every group with no filter. Option rows with a `deleteDate` are included; skip them when
+ * listing options.
+ */
+declare function useProductComponent(params?: FetchProductComponentsParams, options?: RequestOptions): QueryState<ProductComponent[]>;
+//#endregion
 //#region src/hooks/usePromotion.d.ts
 /**
  * Auto-fetches promotions on mount and whenever the params change.
@@ -738,5 +805,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, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
+export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, useProductComponent, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
 //# sourceMappingURL=index.d.cts.map

package/dist/hooks/index.d.ts

@@ -183,6 +183,32 @@ interface FetchProductsParams {
   token?: string;
 }
 //#endregion
+//#region src/core/store.d.ts
+interface Store {
+  id: number;
+  lat: number;
+  lng: number;
+  addressLine1: string;
+  addressLine2: string | null;
+  addressLine3: string;
+  phoneNumber: string;
+  city: string;
+  postcode: string;
+  countryId: number | null;
+  timezoneId: number | null;
+  storeDeleteDate: string | null;
+  email: string | null;
+  sandbox: boolean | null;
+}
+interface FetchStoresParams {
+  /** Optional id filter. */
+  storeIds?: Array<number>;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+  /** @deprecated Pass `options.token` instead. Sent the same way (Authorization header). */
+  token?: string;
+}
+//#endregion
 //#region src/core/promotion.d.ts
 /** Promotion rule identifiers as stored by the Shopwave API. */
 declare enum PromotionRuleSet {
@@ -226,30 +252,62 @@ interface FetchPromotionsParams {
   token?: string;
 }
 //#endregion
-//#region src/core/store.d.ts
-interface Store {
+//#region src/core/productComponent.d.ts
+/**
+ * Product components are modifier groups: a group belongs to a parent product
+ * (`productId`) and offers other products as options. Each option product has
+ * one or more option rows (`productInstances`). See `SHOPWAVE_ENTITIES.productComponent`
+ * for what the live API does on reads, saves and deletes.
+ */
+/** One option row of a product component. */
+interface ProductComponentInstance {
   id: number;
-  lat: number;
-  lng: number;
-  addressLine1: string;
-  addressLine2: string | null;
-  addressLine3: string;
-  phoneNumber: string;
-  city: string;
-  postcode: string;
-  countryId: number | null;
-  timezoneId: number | null;
-  storeDeleteDate: string | null;
-  email: string | null;
-  sandbox: boolean | null;
-}
-interface FetchStoresParams {
-  /** Optional id filter. */
-  storeIds?: Array<number>;
-  /** Whether to include soft-deleted records. Defaults to `false`. */
+  /** Name override for the option; `null` or `""` means the product's own name. Stored as sent. */
+  name: string | null;
+  /** Price as a decimal string, pence excluding VAT (reads return `"100.0"` for `"100"`). */
+  price: string;
+  /** VAT as a fraction string (`"0.200"`). */
+  vatPercentage: string;
+  quantity: number;
+  /** Comma-separated price tags, or `null`. Stored as sent (not trimmed). */
+  tags: string | null;
+  size?: string | null;
+  activeDate?: string | null;
+  /** Set once the row has been deleted; deleted rows still appear in live reads. */
+  deleteDate?: string | null;
+}
+/** A product offered as an option in a product component, with its option rows. */
+interface ProductComponentProduct {
+  id: number;
+  name: string;
+  barcode?: string | null;
+  details?: string | null;
+  unit?: number | null;
+  activeDate?: string | null;
+  /** Option rows, keyed by row id on reads. */
+  productInstances: Record<string, ProductComponentInstance>;
+}
+/** A product component (modifier group). */
+interface ProductComponent {
+  id: number;
+  name: string;
+  /** The parent product the group belongs to. */
+  productId: number;
+  minQuantity: number;
+  maxQuantity: number;
+  productTimestamp?: string;
+  /** Set once the group has been deleted (only `deleted: true` reads return it then). */
+  deleteDate?: string | null;
+  /** Option products, keyed by product id. */
+  products: Record<string, ProductComponentProduct>;
+}
+interface FetchProductComponentsParams {
+  /** Parent products whose groups to read. */
+  productIds?: ReadonlyArray<number | string>;
+  /** Groups to read, by id. */
+  productComponentIds?: ReadonlyArray<number | string>;
+  /** `false` (default): live groups only. `true`: deleted groups only. */
   deleted?: boolean;
-  /** @deprecated Pass `options.token` instead. Sent the same way (Authorization header). */
-  token?: string;
 }
 //#endregion
 //#region src/core/report.d.ts
@@ -585,6 +643,15 @@ declare function useProductTags(options?: LookupOptions): QueryState<string[]>;
  */
 declare function useProductInstanceTags(options?: LookupOptions): QueryState<string[]>;
 //#endregion
+//#region src/hooks/useProductComponent.d.ts
+/**
+ * Auto-fetches product components (modifier groups) on mount and whenever the params change:
+ * a product's groups with `{ productIds: [id] }`, one group with `{ productComponentIds: [id] }`,
+ * or every group with no filter. Option rows with a `deleteDate` are included; skip them when
+ * listing options.
+ */
+declare function useProductComponent(params?: FetchProductComponentsParams, options?: RequestOptions): QueryState<ProductComponent[]>;
+//#endregion
 //#region src/hooks/usePromotion.d.ts
 /**
  * Auto-fetches promotions on mount and whenever the params change.
@@ -738,5 +805,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, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
+export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useMerchant, useProduct, useProductComponent, useProductInstanceTags, useProductTags, usePromotion, useReport, useSession, useStore, useSubmit, useUpdateMerchant, useUploadImage, useUploadMerchantImage, useUser };
 //# sourceMappingURL=index.d.ts.map