basketeer 0.1.1 → 0.1.2

package/README.md

@@ -141,6 +141,7 @@ The full grocery lifecycle, typed end to end:
 
 - **Nutrition** — typed macros and structured micros, normalized from a product's on-pack rows when present; filter and rank a search by nutrition (anonymous)
 - **Catalogue** — `search`, `getProduct`, `browseCategory` (anonymous); `favourites` / "my usuals" (authed)
+- **Product images** — `imageUrl` on every product/result; `resizeImageUrl(url, { width, height })` for thumbnails (anonymous)
 - **Basket** — `add`, `set`, `remove`, `get`
 - **Slots** — delivery and collection: `list` / `book` / `release`
 - **Orders** — `list`, `amend`, `cancel`, `lastFulfilled` (reorder)

package/dist/images.d.ts

@@ -0,0 +1,5 @@
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+export declare function resizeImageUrl(imageUrl: string | null, size: ImageSize): string | null;

package/dist/images.js

@@ -0,0 +1,15 @@
+function assertPositiveInteger(value, name) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new RangeError(`${name} must be a positive integer`);
+    }
+}
+export function resizeImageUrl(imageUrl, size) {
+    if (imageUrl === null)
+        return null;
+    assertPositiveInteger(size.width, "width");
+    assertPositiveInteger(size.height, "height");
+    const url = new URL(imageUrl);
+    url.searchParams.set("w", String(size.width));
+    url.searchParams.set("h", String(size.height));
+    return url.toString();
+}

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export type { AuthBackend, Credentials, OtpProvider } from "./auth/types.js";
 export type { Amendment, BasketeerOptions, BasketItemInput } from "./client.js";
 export { Basketeer } from "./client.js";
 export { ApiKeyError, AuthExpiredError, BasketeerError, GraphQLRequestError, LineRejectedError, NotFoundError, RateLimitedError, } from "./errors.js";
+export type { ImageSize } from "./images.js";
+export { resizeImageUrl } from "./images.js";
 export type { Basket, BasketLine, BookedSlot, MacroFilterKey, Macros, Micronutrient, Nutrition, NutritionBasis, NutritionFilter, NutritionSort, Order, OrderAddress, OrderItem, OrderSlot, PackSize, Price, Product, Promotion, Range, SearchPage, SearchResult, Session, Slot, } from "./models.js";
 export { filterByNutrition, parseNutrition } from "./nutrition.js";
 export type { FulfilmentType, OrderContext } from "./operations.js";

package/dist/index.js

@@ -4,6 +4,7 @@ export { keepCookie, sessionFromCookies } from "./auth/harvest.js";
 export { Basketeer } from "./client.js";
 // Errors
 export { ApiKeyError, AuthExpiredError, BasketeerError, GraphQLRequestError, LineRejectedError, NotFoundError, RateLimitedError, } from "./errors.js";
+export { resizeImageUrl } from "./images.js";
 // Nutrition
 export { filterByNutrition, parseNutrition } from "./nutrition.js";
 // Config & helpers

package/dist/models.d.ts

@@ -22,6 +22,7 @@ export interface Product {
     tpnb: string | null;
     title: string;
     brand: string | null;
+    imageUrl: string | null;
     price: Price;
     packSize: PackSize | null;
     promotions: Promotion[];
@@ -36,6 +37,7 @@ export interface SearchResult {
     tpnb: string | null;
     title: string;
     brand: string | null;
+    imageUrl: string | null;
     price: Price;
     onOffer: boolean;
     promotions: Promotion[];

package/dist/parsers.js

@@ -43,6 +43,7 @@ export function parseProduct(v) {
         tpnb: id(node.tpnb),
         title: str(node.title) ?? "",
         brand: str(node.brandName),
+        imageUrl: str(node.defaultImageUrl),
         price: parsePrice(node.price),
         packSize: parsePackSize(details.packSize),
         promotions: parsePromotions(node.promotions),
@@ -67,6 +68,7 @@ export function parseProductNode(v) {
         tpnb: id(node.tpnb),
         title: str(node.title) ?? "",
         brand: str(node.brandName),
+        imageUrl: str(node.defaultImageUrl),
         price: parsePrice(seller.price),
         onOffer: promotions.length > 0,
         promotions,

package/dist/queries.js

@@ -5,7 +5,7 @@
 export const GET_PRODUCT = `
 query GetProduct($tpnc: String!) {
   product(tpnc: $tpnc) {
-    tpnb tpnc title brandName
+    tpnb tpnc title brandName defaultImageUrl
     price { actual unitPrice unitOfMeasure }
     promotions {
       description
@@ -28,7 +28,7 @@ query Search($query: String!, $page: Int = 1, $count: Int) {
       node {
         __typename
         ... on ProductInterface {
-          tpnc tpnb title brandName
+          tpnc tpnb title brandName defaultImageUrl
           sellers {
             results {
               price { actual unitPrice unitOfMeasure }
@@ -53,7 +53,7 @@ query GetCategoryProducts($facet: ID, $page: Int = 1, $count: Int) {
       node {
         __typename
         ... on ProductInterface {
-          tpnc tpnb title brandName
+          tpnc tpnb title brandName defaultImageUrl
           sellers {
             results {
               price { actual unitPrice unitOfMeasure }
@@ -71,7 +71,7 @@ query GetFavourites($page: Int = 1, $count: Int, $sortBy: String) {
     products {
       __typename
       ... on ProductInterface {
-        tpnc tpnb title brandName
+        tpnc tpnb title brandName defaultImageUrl
         sellers {
           results {
             price { actual unitPrice unitOfMeasure }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basketeer",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Typed, pure-HTTP TypeScript SDK for your own Tesco grocery account — search, basket, delivery slots, and orders over plain fetch. Browser only for login + payment.",
   "type": "module",
   "license": "MIT",