@bowmark/web 1.14.0 → 1.15.0

package/dist/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: faf4c09938555367990a9c8f7a153fdf8acc74126cd25dc3d424ccd9eb0d1077
-// 42 capabilities, 326 providers, 823 typed functions, 20 refused.
+// Manifest version: 23b6633ded987b433276311bd6c89f96297649a628b9687bc4fbd8d39745a4ee
+// 43 capabilities, 331 providers, 833 typed functions, 20 refused.
 // 51,715 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
@@ -1670,6 +1670,49 @@ type ProductResult = {
   }
 }
 
+declare namespace BowmarkCapability_pet_boarding {
+  // ── Overnight pet boarding search — the unit's own declarations, verbatim ──
+type PetBoardingSitter = {
+  name: string
+  profileUrl: string
+  ratingValue: number | null
+  reviewCount: number | null
+  startingNightlyRateCents: number   // before the provider's service fee and per-pet pricing
+  currency: string
+  location: string | null
+  distanceMi: number | null
+}
+type SearchPetBoardingResult = {
+  location: string
+  startDate: string
+  endDate: string
+  sitters: PetBoardingSitter[]   // [] when nothing is listed — a real, complete answer
+  warnings: string[]             // always present; empty when nothing was dropped
+}
+
+type CallOptions = {
+  timeoutMs?: number   // per-provider budget in ms, default 30000, clamped to 1000-55000.
+                       // A provider slower than this is DROPPED from the results and
+                       // NAMED in warnings — never silently absent
+}
+
+  /**
+   * Finds overnight pet-boarding sitters for a city and a specific date range — starting nightly
+   * rate, rating, review count and distance — aggregated via Rover.
+   */
+  interface Unit {
+    /**
+     * Searches overnight pet-boarding sitters for a city and increasing ISO start/end dates —
+     * `bowmark.pet_boarding.search({ location: "Austin, TX", startDate: "2026-12-24", endDate:
+     * "2026-12-28" })`. Returns each sitter's starting per-night rate for that stay (before the
+     * provider's service fee and before per-pet pricing), rating, review count and distance.
+     * Returns `sitters: []` when nothing is listed for that city and stay, a real, complete
+     * answer, not a failure.
+     */
+    search(args: { location: string; startDate: string; endDate: string }, options?: CallOptions): Promise<SearchPetBoardingResult>;
+  }
+}
+
 declare namespace BowmarkCapability_phone_price {
   // ── Phone price comparison (carriers) — the unit's own declarations, verbatim ──
 type PhonePriceOffer = {
@@ -5539,7 +5582,7 @@ declare namespace BowmarkProvider_bigjoeforklifts {
 interface BigJoeRoiQuestion {
   questionNumber: number;   // the tool's own 1-based question number
   prompt: string;           // the question's own text, verbatim
-  options: string[];        // the real current choices for this question
+  options: string[];        // the real current choices, or [] for a typed-in answer
 }
 interface BigJoeRoiEstimatorInputs {
   questions: BigJoeRoiQuestion[];
@@ -5555,16 +5598,16 @@ interface BigJoeQuotePreview {
 }
 
   /**
-   * Big Joe Forklifts' real 17-question Runtime & ROI estimator's live input options, and its
-   * real current forklift model list for a quote request — the tools their own site already
+   * Big Joe Forklifts' real Runtime & ROI estimator's live input questions and option lists, and
+   * its real current forklift model list for a quote request — the tools their own site already
    * computes, read straight off the live site rather than guessed from brochure PDFs.
    */
   interface Unit {
     /**
-     * Reads Big Joe's own 'Pre-Demo Runtime & ROI Estimator' and returns its real current 17
-     * questions and their real option lists (truck model, load weight, lift height, ramps,
-     * attachments, speed limit, facility location, fuel type, and more) straight off the tool's
-     * own workbook.
+     * Reads Big Joe's own 'Pre-Demo Runtime & ROI Estimator' and returns its real current numbered
+     * questions and the real option list for each one the tool publishes a dropdown for (truck
+     * model, load weight, lift height, ramps, attachments, speed limit, facility location, fuel
+     * type, and more) straight off the tool's own workbook.
      */
     getRuntimeEstimatorInputs(): Promise<BigJoeRoiEstimatorInputs>;
 
@@ -16481,6 +16524,71 @@ interface KaleidescapeFindDealersOptions {
   }
 }
 
+declare namespace BowmarkProvider_kalshi {
+  // ── Kalshi — the unit's own declarations, verbatim ──
+interface KalshiMarket {
+  ticker: string;
+  eventTicker: string;
+  title: string;
+  subtitle: string;
+  status: string;
+  marketType: string;
+  openTime: string;
+  closeTime: string;
+  yesBid: string;
+  yesAsk: string;
+  noBid: string;
+  noAsk: string;
+  lastPrice: string;
+  volume: string;
+  volume24h: string;
+  openInterest: string;
+  liquidity: string;
+  rules: string;
+}
+interface KalshiGetMarketsOptions {
+  status?: string;
+  series_ticker?: string;
+  event_ticker?: string;
+  limit?: number;
+  cursor?: string;
+}
+interface KalshiGetMarketsResult {
+  markets: KalshiMarket[];
+  cursor: string;
+  warnings: string[];
+}
+
+  /**
+   * Kalshi's own public trading API, keyless. Built: list/filter live prediction-market
+   * contracts (getMarkets) and read one market's full detail by ticker (getMarket) — prices,
+   * volume, open interest, status, close time.
+   */
+  interface Unit {
+    /**
+     * Lists Kalshi's own live prediction-market contracts off its public, keyless REST endpoint —
+     * each market's ticker, title, status, open/close time, yes/no bid and ask prices (as strings,
+     * e.g. "0.0570"), last price, volume, 24h volume, open interest and liquidity.
+     * `options.status` filters to `open`/`closed`/`settled`/`unopened`; `options.series_ticker` or
+     * `options.event_ticker` narrows to one series or event (found via a series/event browse
+     * elsewhere — this provider does not wrap `/series` or `/events`); `options.limit` (1-1000,
+     * default 100) and `options.cursor` (Kalshi's own opaque token, from a prior response's
+     * `cursor`) page through results. This is the locator: a caller without an existing ticker
+     * starts here, then reads one market's full detail with `getMarket`.
+     */
+    getMarkets(options?: KalshiGetMarketsOptions): Promise<KalshiGetMarketsResult>;
+
+    /**
+     * Reads one Kalshi market's full detail by its own ticker (e.g. `"KXWCGROUPBOTTOM-26L-BRA"`,
+     * found via `getMarkets`) off Kalshi's public, keyless REST endpoint — title, subtitle,
+     * status, open/close time, current yes/no bid and ask prices, last price, volume, open
+     * interest, liquidity and the primary rules text governing settlement. THROWS on an unknown
+     * ticker (404) or a rate limit (429).
+     */
+    getMarket(ticker: string): Promise<KalshiMarket>;
+  }
+}
+
 declare namespace BowmarkProvider_kayak {
   // ── Kayak — the unit's own declarations, verbatim ──
 interface KayakQuery {
@@ -19273,6 +19381,32 @@ interface medicareGetPlanQuery {
   }
 }
 
+declare namespace BowmarkProvider_mercari {
+  // ── Mercari — the unit's own declarations, verbatim ──
+interface MercariSearchResult {
+  itemId: string;
+  name: string;
+  price: number;
+  wasPrice: number | null;
+  brand: string | null;
+  size: string | null;
+  url: string;
+}
+
+  /**
+   * Large peer-to-peer resale marketplace (clothing, electronics, collectibles) — keyword search
+   * over live listings with real, current prices.
+   */
+  interface Unit {
+    /**
+     * Runs a Mercari US keyword search the way mercari.com's own search box does and returns each
+     * matching listing — item id, name, current price, the crossed-out original price when
+     * discounted, brand, size and the listing's own mercari.com URL.
+     */
+    search(query: string | { query: string; limit?: number }): Promise<MercariSearchResult[]>;
+  }
+}
+
 declare namespace BowmarkProvider_mergify {
   // ── Mergify — the unit's own declarations, verbatim ──
 interface mergifyBatch {
@@ -20535,6 +20669,72 @@ interface StoreStock {
   }
 }
 
+declare namespace BowmarkProvider_nfa_futures_org {
+  // ── NFA BASIC — the unit's own declarations, verbatim ──
+interface NfaEntity {
+  nfaId: string;                       // "0229152"
+  name: string;
+  membershipStatus: string | null;     // e.g. "NFA MEMBER APPROVED, SWAP DEALER REGISTERED"
+  registrationTypes: string | null;    // e.g. "Swap Dealer, Exempt Commodity Trading Advisor"
+  hasRegulatoryActions: boolean;
+  entityToken: string;                 // BASIC's own encrypted per-search token
+  profileUrl: string;                  // this entity's BasicNet profile page
+}
+
+  /**
+   * NFA's own BASIC registry — search a firm or individual by name, or look one up by NFA ID,
+   * for its current membership status, registration types and whether it carries regulatory
+   * actions.
+   */
+  interface Unit {
+    /**
+     * Firms NFA's own BASIC registry lists for a name query (e.g. "JPMorgan Chase Bank") — NFA ID,
+     * membership status, registration types and whether NFA shows any regulatory action against
+     * it. The door for a caller who only knows the firm's name.
+     */
+    searchFirms(name: string): Promise<NfaEntity[]>;
+
+    /**
+     * Individuals NFA's own BASIC registry lists for a name query (e.g. "Smith") — NFA ID,
+     * membership status, registration types and whether NFA shows any regulatory action against
+     * them. The door for a caller who only knows the person's name.
+     */
+    searchIndividuals(name: string): Promise<NfaEntity[]>;
+
+    /**
+     * One firm or individual's current NFA membership status and registration types, by NFA ID
+     * (e.g. "0229152"), or by pasting a BasicNet profile URL (its "nfaid" query parameter is read
+     * for you). THROWS if BASIC lists no registrant under that id.
+     */
+    lookupByNfaId(nfaId: string): Promise<NfaEntity>;
+  }
+}
+
+declare namespace BowmarkProvider_npmjs {
+  // ── npm — the unit's own declarations, verbatim ──
+interface npmjsDownloads {
+  package: string;
+  downloads: number;
+  start: string;  // ISO date
+  end: string;    // ISO date
+}
+
+  /**
+   * npmjs.com's own public download-counts API — real weekly/daily/monthly download totals (or a
+   * custom date range) for any published npm package, scoped or not.
+   */
+  interface Unit {
+    /**
+     * The real download count for an npm package, straight off npmjs.com's own public
+     * download-counts API — the same number npmjs.com's own package page shows. `period` is
+     * `"last-day"`, `"last-week"` (default) or `"last-month"`, or a custom
+     * `"YYYY-MM-DD:YYYY-MM-DD"` range. Works on scoped packages (`"@babel/core"`) exactly as on
+     * unscoped ones.
+     */
+    getDownloads(packageName: string, period?: string): Promise<npmjsDownloads>;
+  }
+}
+
 declare namespace BowmarkProvider_nutrafol {
   // ── Nutrafol — the unit's own declarations, verbatim ──
 interface RootCause {
@@ -21654,6 +21854,43 @@ interface platform_claude_comDocLink {
   }
 }
 
+declare namespace BowmarkProvider_polymarket {
+  // ── Polymarket — the unit's own declarations, verbatim ──
+interface polymarketMarket {
+  slug: string;
+  question: string;
+  outcomes: string[];
+  outcomePrices: number[];
+  volume: number;
+  liquidity: number | null;
+  endDate: string | null;
+  active: boolean;
+  closed: boolean;
+}
+
+  /**
+   * Polymarket's own prediction markets — search by keyword or browse the newest, and read one
+   * market's question, live outcome prices, volume and status by slug.
+   */
+  interface Unit {
+    /**
+     * Searches Polymarket's own markets by keyword, e.g. "election" or "bitcoin" — the same search
+     * its own site uses. Omit `query` to list the newest active markets instead. Each row carries
+     * the market's slug (what `getMarket` takes), its question, its outcomes and their current
+     * prices (0-1 implied probabilities), volume, liquidity (when the door carries it) and whether
+     * it is still active/open. `limit` caps how many rows come back (default 20, capped at 100).
+     */
+    search(query?: string, limit?: number): Promise<polymarketMarket[]>;
+
+    /**
+     * Reads one Polymarket market by its slug (the id `search` returns, e.g.
+     * "xi-jinping-out-before-2027") — its question, outcomes, current outcome prices, volume,
+     * liquidity, end date and open/closed status, straight from the site's own API.
+     */
+    getMarket(slug: string): Promise<polymarketMarket>;
+  }
+}
+
 declare namespace BowmarkProvider_poshmark {
   // ── Poshmark — the unit's own declarations, verbatim ──
 interface PoshmarkSupportArticle {
@@ -27837,16 +28074,18 @@ interface XpressWaitTime {
 }
 
   /**
-   * Reads Xpress Wellness Urgent Care's clinic roster and each clinic's live healow wait-time /
-   * check-in widget — no key, no browser.
+   * Reads the Xpress Wellness / Integrity Urgent Care clinic roster and each clinic's live
+   * healow wait-time / check-in widget — no key, no browser.
    */
   interface Unit {
     /**
-     * Lists every Xpress Wellness Urgent Care clinic — 40 locations across Oklahoma, Kansas and
-     * one Texas site — with name, address, phone, the clinic's own detail page and the healow
-     * check-in widget URL + facility_id. Takes nothing. The facilityId it returns is what
-     * checkWaitTime takes. THROWS rather than returning [] when the roster page answers with no
-     * clinics — the roster is never honestly empty.
+     * Lists Xpress Wellness / Integrity Urgent Care clinics — recovered by confirming each healow
+     * facility_id's own brand, then matching it against the site's current roster for a name and
+     * address — with name, address, the clinic's own detail page when matched and the healow
+     * check-in widget URL + facility_id. Takes nothing. phone is always null (neither source
+     * publishes one any more). The facilityId it returns is what checkWaitTime takes. THROWS
+     * rather than returning [] when no facility_id resolves to a confirmed clinic — the roster is
+     * never honestly empty.
      */
     listFacilities(): Promise<XpressFacility[]>;
 
@@ -29163,6 +29402,7 @@ interface BowmarkProviders {
   junkluggers: BowmarkProvider_junkluggers.Unit;
   justinwine: BowmarkProvider_justinwine.Unit;
   kaleidescape: BowmarkProvider_kaleidescape.Unit;
+  kalshi: BowmarkProvider_kalshi.Unit;
   kayak: BowmarkProvider_kayak.Unit;
   keepa: BowmarkProvider_keepa.Unit;
   kingsdown: BowmarkProvider_kingsdown.Unit;
@@ -29191,6 +29431,7 @@ interface BowmarkProviders {
   mcp_so: BowmarkProvider_mcp_so.Unit;
   medicalguardian: BowmarkProvider_medicalguardian.Unit;
   medicare: BowmarkProvider_medicare.Unit;
+  mercari: BowmarkProvider_mercari.Unit;
   mergify: BowmarkProvider_mergify.Unit;
   microcenter: BowmarkProvider_microcenter.Unit;
   millisaraylar: BowmarkProvider_millisaraylar.Unit;
@@ -29207,6 +29448,8 @@ interface BowmarkProviders {
   nationalbusinessfurniture: BowmarkProvider_nationalbusinessfurniture.Unit;
   newageproducts: BowmarkProvider_newageproducts.Unit;
   newegg: BowmarkProvider_newegg.Unit;
+  nfa_futures_org: BowmarkProvider_nfa_futures_org.Unit;
+  npmjs: BowmarkProvider_npmjs.Unit;
   nutrafol: BowmarkProvider_nutrafol.Unit;
   nvisioncenters: BowmarkProvider_nvisioncenters.Unit;
   oanda: BowmarkProvider_oanda.Unit;
@@ -29222,6 +29465,7 @@ interface BowmarkProviders {
   pirateship: BowmarkProvider_pirateship.Unit;
   pizzahut: BowmarkProvider_pizzahut.Unit;
   platform_claude_com: BowmarkProvider_platform_claude_com.Unit;
+  polymarket: BowmarkProvider_polymarket.Unit;
   poshmark: BowmarkProvider_poshmark.Unit;
   positivegrid: BowmarkProvider_positivegrid.Unit;
   premierbuildings: BowmarkProvider_premierbuildings.Unit;
@@ -81053,6 +81297,7 @@ interface BowmarkLibrary {
   mcp_registry: BowmarkCapability_mcp_registry.Unit;
   music: BowmarkCapability_music.Unit;
   pcparts: BowmarkCapability_pcparts.Unit;
+  pet_boarding: BowmarkCapability_pet_boarding.Unit;
   phone_price: BowmarkCapability_phone_price.Unit;
   phone_trade_in: BowmarkCapability_phone_trade_in.Unit;
   pricing: BowmarkCapability_pricing.Unit;

package/dist/generated/validators.js

@@ -5,10 +5,10 @@
 // declares no readable argument shape — not an absent one, which is what the
 // guard fails closed on.
 //
-// Manifest version: faf4c09938555367990a9c8f7a153fdf8acc74126cd25dc3d424ccd9eb0d1077
-// 805 checked, 20 unchecked.
+// Manifest version: 23b6633ded987b433276311bd6c89f96297649a628b9687bc4fbd8d39745a4ee
+// 815 checked, 20 unchecked.
 export const VALIDATORS = {
-    "version": "faf4c09938555367990a9c8f7a153fdf8acc74126cd25dc3d424ccd9eb0d1077",
+    "version": "23b6633ded987b433276311bd6c89f96297649a628b9687bc4fbd8d39745a4ee",
     "units": {
         "bundles": {
             "defs": {},
@@ -1699,6 +1699,64 @@ export const VALIDATORS = {
                 ]
             }
         },
+        "pet_boarding": {
+            "defs": {
+                "CallOptions": {
+                    "k": "object",
+                    "props": [
+                        {
+                            "name": "timeoutMs",
+                            "schema": {
+                                "k": "number"
+                            },
+                            "optional": true
+                        }
+                    ]
+                }
+            },
+            "functions": {
+                "search": [
+                    {
+                        "name": "args",
+                        "schema": {
+                            "k": "object",
+                            "props": [
+                                {
+                                    "name": "location",
+                                    "schema": {
+                                        "k": "string"
+                                    },
+                                    "optional": false
+                                },
+                                {
+                                    "name": "startDate",
+                                    "schema": {
+                                        "k": "string"
+                                    },
+                                    "optional": false
+                                },
+                                {
+                                    "name": "endDate",
+                                    "schema": {
+                                        "k": "string"
+                                    },
+                                    "optional": false
+                                }
+                            ]
+                        },
+                        "optional": false
+                    },
+                    {
+                        "name": "options",
+                        "schema": {
+                            "k": "ref",
+                            "name": "CallOptions"
+                        },
+                        "optional": true
+                    }
+                ]
+            }
+        },
         "phone_price": {
             "defs": {},
             "functions": {
@@ -13745,6 +13803,71 @@ export const VALIDATORS = {
                 ]
             }
         },
+        "providers.kalshi": {
+            "defs": {
+                "KalshiGetMarketsOptions": {
+                    "k": "object",
+                    "props": [
+                        {
+                            "name": "status",
+                            "schema": {
+                                "k": "string"
+                            },
+                            "optional": true
+                        },
+                        {
+                            "name": "series_ticker",
+                            "schema": {
+                                "k": "string"
+                            },
+                            "optional": true
+                        },
+                        {
+                            "name": "event_ticker",
+                            "schema": {
+                                "k": "string"
+                            },
+                            "optional": true
+                        },
+                        {
+                            "name": "limit",
+                            "schema": {
+                                "k": "number"
+                            },
+                            "optional": true
+                        },
+                        {
+                            "name": "cursor",
+                            "schema": {
+                                "k": "string"
+                            },
+                            "optional": true
+                        }
+                    ]
+                }
+            },
+            "functions": {
+                "getMarkets": [
+                    {
+                        "name": "options",
+                        "schema": {
+                            "k": "ref",
+                            "name": "KalshiGetMarketsOptions"
+                        },
+                        "optional": true
+                    }
+                ],
+                "getMarket": [
+                    {
+                        "name": "ticker",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    }
+                ]
+            }
+        },
         "providers.kayak": {
             "defs": {
                 "KayakCarQuery": {
@@ -15610,6 +15733,44 @@ export const VALIDATORS = {
                 ]
             }
         },
+        "providers.mercari": {
+            "defs": {},
+            "functions": {
+                "search": [
+                    {
+                        "name": "query",
+                        "schema": {
+                            "k": "union",
+                            "of": [
+                                {
+                                    "k": "string"
+                                },
+                                {
+                                    "k": "object",
+                                    "props": [
+                                        {
+                                            "name": "query",
+                                            "schema": {
+                                                "k": "string"
+                                            },
+                                            "optional": false
+                                        },
+                                        {
+                                            "name": "limit",
+                                            "schema": {
+                                                "k": "number"
+                                            },
+                                            "optional": true
+                                        }
+                                    ]
+                                }
+                            ]
+                        },
+                        "optional": false
+                    }
+                ]
+            }
+        },
         "providers.mergify": {
             "defs": {},
             "functions": {
@@ -16574,6 +16735,59 @@ export const VALIDATORS = {
                 ]
             }
         },
+        "providers.nfa_futures_org": {
+            "defs": {},
+            "functions": {
+                "searchFirms": [
+                    {
+                        "name": "name",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    }
+                ],
+                "searchIndividuals": [
+                    {
+                        "name": "name",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    }
+                ],
+                "lookupByNfaId": [
+                    {
+                        "name": "nfaId",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    }
+                ]
+            }
+        },
+        "providers.npmjs": {
+            "defs": {},
+            "functions": {
+                "getDownloads": [
+                    {
+                        "name": "packageName",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    },
+                    {
+                        "name": "period",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": true
+                    }
+                ]
+            }
+        },
         "providers.nutrafol": {
             "defs": {},
             "functions": {
@@ -17640,6 +17854,36 @@ export const VALIDATORS = {
                 "listDocPages": []
             }
         },
+        "providers.polymarket": {
+            "defs": {},
+            "functions": {
+                "search": [
+                    {
+                        "name": "query",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": true
+                    },
+                    {
+                        "name": "limit",
+                        "schema": {
+                            "k": "number"
+                        },
+                        "optional": true
+                    }
+                ],
+                "getMarket": [
+                    {
+                        "name": "slug",
+                        "schema": {
+                            "k": "string"
+                        },
+                        "optional": false
+                    }
+                ]
+            }
+        },
         "providers.poshmark": {
             "defs": {},
             "functions": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bowmark/web",
-  "version": "1.14.0",
+  "version": "1.15.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",