@bowmark/web 1.2.0 → 1.3.0

package/README.md

@@ -29,7 +29,11 @@ autocomplete is the entire promise. What exists to call is listed, one row per
 function, in
 [`CAPABILITIES.md`](https://github.com/bowmark-ai/web/blob/main/CAPABILITIES.md) and
 [`PROVIDERS.md`](https://github.com/bowmark-ai/web/blob/main/PROVIDERS.md) — absolute
-URLs, because this README is read on npm where a relative link resolves to nothing.
+URLs, because this README is read on npm where a relative link resolves to nothing. What
+changed between versions is
+[`CHANGELOG.md`](https://github.com/bowmark-ai/web/blob/main/CHANGELOG.md), which is
+generated by diffing those same two tables, so it describes the callable surface and
+nothing else.
 
 **Zero runtime dependencies, permanently.** Not an aspiration — the argument guard is
 plain JS rather than a validator library, and the envelope shapes are hand-restated

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bowmark/web",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "description": "The public client for the Bowmark capability library — real TypeScript for the whole bowmark.* surface, with no Bowmark source on the caller's disk. ZERO runtime dependencies, deliberately and permanently.",
   "license": "MIT",

package/src/generated/library.d.ts

@@ -5,8 +5,8 @@
 // rather than imported. An `import` or `export` at the top level of this file would
 // turn it into a module and every declaration below would stop being global.
 //
-// Manifest version: 11b1a109d7e69ffbbcccb30182dd5333770aeb23ab75946f15d55d7f7d84a7bf
-// 8 capabilities, 68 providers, 208 typed functions, 20 refused.
+// Manifest version: 80346d8cf36c785e2b7fe0a77a87e5a51fa97ceb04ea11c951c71a9f7f75ad8e
+// 8 capabilities, 71 providers, 214 typed functions, 20 refused.
 // 51,711 family members, sharing 2 interface(s) — declared once and pointed at, never repeated per member.
 //
 // REFUSED — these functions are real and callable, and their declared arguments
@@ -1965,6 +1965,102 @@ interface CloudflareSearchDomainAvailabilityResult {
   }
 }
 
+declare namespace BowmarkProvider_decked {
+  // ── DECKED — the unit's own declarations, verbatim ──
+// DECKED's OWN shapes — not a capability contract.
+
+type DeckedCabSideOption = "Cab-side Gap" | "Load Floor";
+
+interface DeckedFit {
+  vehicleClass: string;       // the site's own product handle, e.g. "drawers-fullsize"
+  vehicleClassTitle: string;
+  model: string;               // e.g. "Ford F150 (2004-2014)"
+  fitOption: string | null;    // a bed length or wheel base — null for a class with only "Model" (SUV, Service Body)
+  sku: string;
+  price: number;
+  priceFormatted: string;
+  available: boolean;
+  url: string;                 // the class's product page, preselecting this exact variant
+}
+
+interface DeckedVehicleClass {
+  handle: string;
+  title: string;
+  url: string;
+  secondOption: string | null; // "Bed Length" | "Wheel Base" | null
+  fits: DeckedFit[];
+}
+
+interface DeckedFitmentResult {
+  query: string;
+  bedLength: string | null;
+  matched: boolean;
+  fit: DeckedFit | null;
+  candidates: DeckedFit[];     // populated when not narrowed to exactly one real fit
+  message: string;
+}
+
+interface DeckedCabSideOptionResult {
+  query: string;
+  bedLength: string;
+  option: DeckedCabSideOption;
+  compatible: boolean;         // false is a real, expected "does not fit" answer — not an error
+  fit: DeckedFit | null;
+  reason: string | null;
+  baseFit: DeckedFit | null;   // the "Cab-side Gap" fit at the same vehicle + bed length (DECKED's standard option), for the price delta
+}
+
+  /**
+   * DECKED's truck-bed/SUV/cargo-van Drawer System vehicle-fitment catalog — list every vehicle
+   * class and model DECKED fits, read one class's full fit list (model, bed length/wheel base,
+   * exact SKU and live price), resolve a free-text vehicle to its real fitted SKU and price, and
+   * price the Load Floor vs Cab-side Gap 8'-bed accessory-pack option (including a real fitment
+   * rejection when a vehicle has no matching SKU), all off the storefront's own live catalog
+   * rather than a researched estimate.
+   */
+  interface Unit {
+    /**
+     * Lists every real DECKED vehicle fit across all six vehicle classes (SUV, Full-Size, Midsize,
+     * Cargo Van, Service Body, RamBox) from the storefront's own live catalog — model, bed
+     * length/wheel base (where the class has one), exact SKU, live price and availability. `query`
+     * (optional) narrows the list by a fuzzy match on the vehicle make/model text, e.g. "4runner"
+     * or "f150". Excludes the generic /products/drawers "Style: Trucks" decoy, which carries no
+     * real per-vehicle fitment.
+     */
+    searchFits(query?: string): Promise<DeckedFit[]>;
+
+    /**
+     * Reads one vehicle class's complete fit list — a handle (e.g. "drawers-fullsize") or a
+     * shopper-shaped name (e.g. "Full-Size", "SUV", "Cargo Van") — every model it fits, each with
+     * its own bed lengths / wheel bases, SKUs, live prices and availability. THROWS on an
+     * unrecognized class, naming searchFits() as the way to find current ones.
+     */
+    getVehicleClass(vehicleClass: string): Promise<DeckedVehicleClass>;
+
+    /**
+     * Resolves a free-text vehicle (e.g. "Toyota 4Runner 2023", "Ford F-150 2015") to its real
+     * fitted SKU and live price, mirroring the on-page widget's own Make/Model/Year -> Bed Length
+     * narrowing flow. `matched: true` with a populated `fit` means exactly one real fit narrowed
+     * to; otherwise `candidates` lists every real fit that DID match the vehicle (pass `bedLength`
+     * to narrow a class that needs one, or read `fitOption` off a candidate). Never throws for an
+     * ambiguous or zero-bed-length match — an unmatched vehicle name is the one case this DOES
+     * treat as a caller error (throws, naming searchFits()).
+     */
+    resolveFitment(vehicleQuery: string, bedLength?: string): Promise<DeckedFitmentResult>;
+
+    /**
+     * Prices DECKED's 8'-bed cab-side accessory-pack option — "Cab-side Gap" or "Load Floor" — for
+     * one vehicle + bed length, against the two real accessory-pack product handles the site
+     * publishes. `compatible: false` + a `reason` is a REAL, expected answer (not an error) for a
+     * vehicle whose class has no 8'-bed SKU in that product line — e.g. an SUV, which has no Bed
+     * Length option at all. `baseFit` (when resolvable) is the "Cab-side Gap" fit at the same
+     * vehicle + bed length — DECKED's standard 8' option — so a caller can read the real dollar
+     * delta the Load Floor upgrade costs.
+     */
+    priceCabSideOption(vehicleQuery: string, bedLength: string, option: DeckedCabSideOption): Promise<DeckedCabSideOptionResult>;
+  }
+}
+
 declare namespace BowmarkProvider_dickssportinggoods {
   // ── DICK'S Sporting Goods — the unit's own declarations, verbatim ──
 interface dickssportinggoodsDayHours {
@@ -5952,6 +6048,31 @@ interface LiquiddeathLiveCart {
   }
 }
 
+declare namespace BowmarkProvider_lonelyplanet {
+  // ── Lonely Planet — the unit's own declarations, verbatim ──
+interface LonelyPlanetSearchResult {
+  title: string;
+  subtitle: string | null;
+  collection: string; // e.g. "destinationAssemblies", "products", "journeysItineraries"
+  url: string;
+}
+
+  /**
+   * Travel guides: destination guides, site search, Best in Travel picks, curated trips and
+   * guidebooks.
+   */
+  interface Unit {
+    /**
+     * Searches lonelyplanet.com's site-wide index — destinations, articles, curated trip
+     * itineraries, guidebooks and points of interest — for a free-text query, the way the site's
+     * own search bar does. Returns each match's title, subtitle, its `collection` (the site's own
+     * result-type tag, e.g. "destinationAssemblies", "products") and a resolvable url. This is the
+     * entry point for a caller who does not yet know which destination page or guide they want.
+     */
+    search(query: string): Promise<LonelyPlanetSearchResult[]>;
+  }
+}
+
 declare namespace BowmarkProvider_lufthansa {
   // ── Lufthansa — the unit's own declarations, verbatim ──
 interface LufthansaFlightLeg {
@@ -8883,6 +9004,47 @@ interface SamsclubMembershipPlan {
   }
 }
 
+declare namespace BowmarkProvider_sears {
+  // ── Sears — the unit's own declarations, verbatim ──
+interface SearsSearchPrice {
+  currentAmount: number;
+  currentDisplay: string;
+  regularAmount: number | null;
+  regularDisplay: string | null;
+  onSale: boolean;
+}
+interface SearsSearchResult {
+  productId: string;
+  url: string;
+  name: string;
+  brand: string | null;
+  price: SearsSearchPrice;
+  thumbnail: string | null;
+  rating: number | null;
+  reviewCount: number | null;
+  totalCount: number;
+}
+interface SearsSearchQuery {
+  query: string;
+  zipCode?: string;
+  limit?: number;
+}
+
+  /** Sears' own storefront — product search, product detail, fulfillment/stock and store locator. */
+  interface Unit {
+    /**
+     * Searches Sears' live catalog by free-text keyword the way the site's own search bar does,
+     * returning matching product rows: id, name, brand, current and regular price, a thumbnail,
+     * rating/review count and the site's own total match count. A query with no matches returns an
+     * empty array — Sears not carrying something is a real, common answer, not an error. `zipCode`
+     * narrows price/availability the way the site's own zip cookie does; omit it for the site's
+     * own default (New York, 10101). Returns one page (up to 48 rows); the site publishes no
+     * further paging parameter this function reaches.
+     */
+    search(query: SearsSearchQuery): Promise<SearsSearchResult[]>;
+  }
+}
+
 declare namespace BowmarkProvider_selectblinds {
   // ── SelectBlinds — the unit's own declarations, verbatim ──
 // SelectBlinds' OWN shapes — not a capability contract.
@@ -10577,6 +10739,7 @@ interface BowmarkProviders {
   chriscraft: BowmarkProvider_chriscraft.Unit;
   classpass: BowmarkProvider_classpass.Unit;
   cloudflare: BowmarkProvider_cloudflare.Unit;
+  decked: BowmarkProvider_decked.Unit;
   dickssportinggoods: BowmarkProvider_dickssportinggoods.Unit;
   dillards: BowmarkProvider_dillards.Unit;
   discounttire: BowmarkProvider_discounttire.Unit;
@@ -10600,6 +10763,7 @@ interface BowmarkProviders {
   labcorp: BowmarkProvider_labcorp.Unit;
   linkedin: BowmarkProvider_linkedin.Unit;
   liquiddeath: BowmarkProvider_liquiddeath.Unit;
+  lonelyplanet: BowmarkProvider_lonelyplanet.Unit;
   lufthansa: BowmarkProvider_lufthansa.Unit;
   mailchimp: BowmarkProvider_mailchimp.Unit;
   mcdonalds: BowmarkProvider_mcdonalds.Unit;
@@ -10621,6 +10785,7 @@ interface BowmarkProviders {
   reddit: BowmarkProvider_reddit.Unit;
   ritani: BowmarkProvider_ritani.Unit;
   samsclub: BowmarkProvider_samsclub.Unit;
+  sears: BowmarkProvider_sears.Unit;
   selectblinds: BowmarkProvider_selectblinds.Unit;
   semihandmade: BowmarkProvider_semihandmade.Unit;
   soundcloud: BowmarkProvider_soundcloud.Unit;

package/src/generated/validators.ts

@@ -5,13 +5,13 @@
 // declares no readable argument shape — not an absent one, which is what the
 // guard fails closed on.
 //
-// Manifest version: 11b1a109d7e69ffbbcccb30182dd5333770aeb23ab75946f15d55d7f7d84a7bf
-// 202 checked, 20 unchecked.
+// Manifest version: 80346d8cf36c785e2b7fe0a77a87e5a51fa97ceb04ea11c951c71a9f7f75ad8e
+// 208 checked, 20 unchecked.
 
 import type { ValidatorTable } from "../validate.js";
 
 export const VALIDATORS: ValidatorTable = {
-  "version": "11b1a109d7e69ffbbcccb30182dd5333770aeb23ab75946f15d55d7f7d84a7bf",
+  "version": "80346d8cf36c785e2b7fe0a77a87e5a51fa97ceb04ea11c951c71a9f7f75ad8e",
   "units": {
     "cars": {
       "defs": {
@@ -2143,6 +2143,83 @@ export const VALIDATORS: ValidatorTable = {
         ]
       }
     },
+    "providers.decked": {
+      "defs": {
+        "DeckedCabSideOption": {
+          "k": "union",
+          "of": [
+            {
+              "k": "literal",
+              "v": "Cab-side Gap"
+            },
+            {
+              "k": "literal",
+              "v": "Load Floor"
+            }
+          ]
+        }
+      },
+      "functions": {
+        "searchFits": [
+          {
+            "name": "query",
+            "schema": {
+              "k": "string"
+            },
+            "optional": true
+          }
+        ],
+        "getVehicleClass": [
+          {
+            "name": "vehicleClass",
+            "schema": {
+              "k": "string"
+            },
+            "optional": false
+          }
+        ],
+        "resolveFitment": [
+          {
+            "name": "vehicleQuery",
+            "schema": {
+              "k": "string"
+            },
+            "optional": false
+          },
+          {
+            "name": "bedLength",
+            "schema": {
+              "k": "string"
+            },
+            "optional": true
+          }
+        ],
+        "priceCabSideOption": [
+          {
+            "name": "vehicleQuery",
+            "schema": {
+              "k": "string"
+            },
+            "optional": false
+          },
+          {
+            "name": "bedLength",
+            "schema": {
+              "k": "string"
+            },
+            "optional": false
+          },
+          {
+            "name": "option",
+            "schema": {
+              "k": "ref",
+              "name": "DeckedCabSideOption"
+            },
+            "optional": false
+          }
+        ]
+      }
+    },
     "providers.dickssportinggoods": {
       "defs": {},
       "functions": {
@@ -4901,6 +4978,20 @@ export const VALIDATORS: ValidatorTable = {
         ]
       }
     },
+    "providers.lonelyplanet": {
+      "defs": {},
+      "functions": {
+        "search": [
+          {
+            "name": "query",
+            "schema": {
+              "k": "string"
+            },
+            "optional": false
+          }
+        ]
+      }
+    },
     "providers.lufthansa": {
       "defs": {},
       "functions": {
@@ -9014,6 +9105,48 @@ export const VALIDATORS: ValidatorTable = {
         "getMembershipPlans": []
       }
     },
+    "providers.sears": {
+      "defs": {
+        "SearsSearchQuery": {
+          "k": "object",
+          "props": [
+            {
+              "name": "query",
+              "schema": {
+                "k": "string"
+              },
+              "optional": false
+            },
+            {
+              "name": "zipCode",
+              "schema": {
+                "k": "string"
+              },
+              "optional": true
+            },
+            {
+              "name": "limit",
+              "schema": {
+                "k": "number"
+              },
+              "optional": true
+            }
+          ]
+        }
+      },
+      "functions": {
+        "search": [
+          {
+            "name": "query",
+            "schema": {
+              "k": "ref",
+              "name": "SearsSearchQuery"
+            },
+            "optional": false
+          }
+        ]
+      }
+    },
     "providers.selectblinds": {
       "defs": {},
       "functions": {

package/src/index.ts

@@ -17,12 +17,14 @@
 // the two must stay in sync — see `packages/runtime/src/namespace.ts`.
 
 import { client } from "./session.js";
-import { type ClientOptions, type RunEnvelope, postRun, resolveClient } from "./transport.js";
+import { type ClientOptions, postRun, type RunEnvelope, resolveClient } from "./transport.js";
 
+export { type WireProblem, wireProblem } from "./guard.js";
+export { client, openManagedSession, type SessionHandle, session } from "./session.js";
 export {
+  type AuthNeed,
   BowmarkError,
   BowmarkNeedsUserError,
-  type AuthNeed,
   type CallEnvelope,
   type ClientOptions,
   type ClosedSession,
@@ -31,8 +33,6 @@ export {
   type OpenedSession,
   type RunEnvelope,
 } from "./transport.js";
-export { type WireProblem, wireProblem } from "./guard.js";
-export { type SessionHandle, client, openManagedSession, session } from "./session.js";
 
 /** The whole callable library, typed. `await bowmark.music.search("aphex twin")`.
  *