basketeer 0.1.0 → 0.1.1

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
 
@@ -260,7 +260,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basketeer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",