basketeer 0.1.0 → 0.1.2

package/README.md

@@ -23,7 +23,7 @@ Run your weekly shop from code, the terminal, or an AI agent. Everything but sig
 <br>
 
 [![CI](https://github.com/tobyandrews1985/basketeer/actions/workflows/ci.yml/badge.svg)](https://github.com/tobyandrews1985/basketeer/actions/workflows/ci.yml)
-[![tests](https://img.shields.io/badge/tests-71%20passing-brightgreen.svg)](tests/)
+[![tests](https://img.shields.io/badge/tests-75%20passing-brightgreen.svg)](tests/)
 [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 [![node >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
 
@@ -39,7 +39,7 @@ Tesco has no public API, and the usual approach (scraping the DOM) shatters on t
 - **Agent-ready.** A stdio MCP server lets Claude or any MCP client run the shop. Read-only and destructive tools are annotated, and checkout never pays.
 - **Typed and lean.** One fully-typed client you import; the CLI and MCP server are built on it. The data path imports no third-party packages (the three runtime deps — commander, the MCP SDK, and zod — are pulled only by the CLI and MCP server). It is pure `fetch` with no Node-only APIs, so it runs on Node and Node-compatible runtimes.
 - **Safe.** `checkout()` stops at the payment URL. A human finishes 3-D Secure in a browser, by design.
-- **Tested.** 71 tests across the data plane and its parsers.
+- **Tested.** 75 tests across the data plane and its parsers.
 
 ## Nutrition, the part nothing else has
 
@@ -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)
@@ -260,7 +261,7 @@ Personal-account interoperability automation: your account, your data. The clien
 
 ```bash
 npm install
-npm test          # 71 tests: vitest unit + regression + smoke
+npm test          # 75 tests: vitest unit + regression + smoke
 npm run build     # clean build to dist/
 npm run example:lookup
 ```

package/dist/cli.js

@@ -8,10 +8,10 @@
  * to stderr with a non-zero exit. Per the SDK's ethics ceiling, `checkout` only
  * hands back a payment URL — a human completes payment in a browser.
  */
-import { fileURLToPath } from "node:url";
 import { Command, InvalidArgumentError } from "commander";
 import { BrowserAuthBackend } from "./auth/browser/playwright.js";
 import { Basketeer, BasketeerError, FileTokenStore } from "./index.js";
+import { isMainModule } from "./is-main.js";
 /** Pretty-print any JSON-serialisable value to stdout. */
 function emit(value) {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
@@ -201,7 +201,7 @@ program
 });
 // --- entrypoint -------------------------------------------------------------
 // Only parse argv when run as a binary, so the module is importable (tests).
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
+if (isMainModule(import.meta.url)) {
     program.parseAsync().catch((err) => {
         const name = err instanceof BasketeerError ? err.name : "Error";
         const message = err instanceof Error ? err.message : String(err);

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/is-main.d.ts

@@ -0,0 +1,8 @@
+/**
+ * True when `moduleUrl` (pass `import.meta.url`) is the entrypoint the process
+ * was launched with. Resolves symlinks first, so it still holds when the module
+ * runs via an installed bin — npx, a global install, or `node_modules/.bin` —
+ * where `process.argv[1]` is a symlink to the real file and a raw `===` against
+ * `fileURLToPath(import.meta.url)` would wrongly be false.
+ */
+export declare function isMainModule(moduleUrl: string): boolean;

package/dist/is-main.js

@@ -0,0 +1,20 @@
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/**
+ * True when `moduleUrl` (pass `import.meta.url`) is the entrypoint the process
+ * was launched with. Resolves symlinks first, so it still holds when the module
+ * runs via an installed bin — npx, a global install, or `node_modules/.bin` —
+ * where `process.argv[1]` is a symlink to the real file and a raw `===` against
+ * `fileURLToPath(import.meta.url)` would wrongly be false.
+ */
+export function isMainModule(moduleUrl) {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(entry) === fileURLToPath(moduleUrl);
+    }
+    catch {
+        return false;
+    }
+}

package/dist/mcp-server.js

@@ -22,12 +22,12 @@
  * Run: `basketeer-mcp` (stdio). Configure it as an MCP server in your agent.
  */
 import { createHash } from "node:crypto";
-import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { BrowserAuthBackend } from "./auth/browser/playwright.js";
 import { Basketeer, BasketeerError, FileTokenStore } from "./index.js";
+import { isMainModule } from "./is-main.js";
 /** Wrap a value as MCP JSON text content. */
 function json(value) {
     return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
@@ -55,7 +55,7 @@ export function confirmToken(parts) {
  * Pure: no filesystem/auth/transport side effects — safe to call from a test.
  */
 export function buildServer(client) {
-    const server = new McpServer({ name: "basketeer", version: "0.1.0" });
+    const server = new McpServer({ name: "basketeer", version: "0.1.1" });
     // --- reads (anonymous OK) -------------------------------------------------
     server.tool("basketeer_search", "Search the Tesco grocery catalogue. Returns matching products with SKU, title, price, and any offers.", {
         query: z.string().describe("Search terms, e.g. 'semi skimmed milk'."),
@@ -153,7 +153,7 @@ export function buildServer(client) {
 // Only build the client (which reads ~/.basketeer/session.json) and attach the
 // stdio transport when run as a binary, so the module can be imported (e.g. by a
 // smoke test) without any filesystem/auth side effects or starting the server.
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
+if (isMainModule(import.meta.url)) {
     const store = new FileTokenStore();
     const client = new Basketeer({
         session: await store.load(),

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.0",
+  "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",
@@ -56,12 +56,16 @@
   "keywords": [
     "tesco",
     "groceries",
+    "grocery",
+    "supermarket",
+    "nutrition",
     "automation",
     "graphql",
     "client",
     "mcp",
     "cli",
-    "ai-agent"
+    "ai-agent",
+    "uk"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",