bmlt-query-client 1.4.0 → 1.4.2

package/.claude/settings.local.json

@@ -1,10 +1,17 @@
 {
   "permissions": {
     "allow": [
-      "Bash(wc -l /Users/pjoyce/workspace/git/bmlt-enabled/bmlt-query-client/src/**/*.ts /Users/pjoyce/workspace/git/bmlt-enabled/bmlt-query-client/test/*.ts)"
+      "Bash(npm view:*)",
+      "Bash(npm ls *)",
+      "Bash(curl -s https://raw.githubusercontent.com/qmhc/unplugin-dts/main/README.md)",
+      "Bash(curl -s https://raw.githubusercontent.com/qmhc/unplugin-dts/main/docs/en/migration-v4-to-v5.md)",
+      "Bash(npm run *)",
+      "Bash(npm test *)",
+      "Bash(tar -xzf bmlt-query-client-1.4.0.tgz)",
+      "Bash(grep -nA 12 '\"scripts\"' /Users/patrick/workspace/git/bmlt-enabled/bmlt-query-client/package.json)",
+      "Bash(grep -nA 3 \"interface Format\" /Users/patrick/workspace/git/bmlt-enabled/crumb-widget/node_modules/bmlt-query-client/dist/app.d.ts)",
+      "Bash(grep -nA 30 \"^function makeMeeting\\\\|^function rawMeeting\\\\|^function rawFormat\\\\|^function makeFormat\\\\|^  function makeGeoMeeting\\\\|^  function makeFormat\" src/tests/unit/format.test.ts src/tests/unit/data.svelte.test.ts src/tests/unit/Controls.svelte.test.ts)",
+      "Bash(grep -nA 30 \"^function makeMeeting\" src/tests/unit/MapView.svelte.test.ts src/tests/unit/MeetingDetail.svelte.test.ts src/tests/unit/MeetingList.svelte.test.ts)"
     ]
-  },
-  "disabledMcpjsonServers": [
-    "laravel-boost"
-  ]
+  }
 }

package/CHANGELOG.md

@@ -6,6 +6,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [1.4.2] - 2026-05-19
+
+### Fixed
+
+- `countUniqueGroups` now matches crouton's long-standing definition: groups are identified by `(service_body, normalized meeting name, location)` — physical coordinates for in-person/hybrid (`venue_type !== 2`), virtual link + additional info for virtual (`venue_type === 2`). The previous algorithm keyed only on `(service_body, name)`, which under-counted whenever two distinct home groups happened to share a name but met at different locations (real-world example: MCANA returned 12 groups vs. crouton's 17 for the same 30 meetings). Bug; widget headers and downstream callers now agree with crouton.
+
+## [1.4.1] - 2026-05-15
+
+### Fixed
+
+- Republish of 1.4.0 with regenerated `dist/` files. The 1.4.0 npm tarball shipped stale type declarations (`dist/app.d.ts` was baked from a 1.3.0-era build), so TypeScript consumers still saw the old `string` types for `Meeting.weekday_tinyint`, `latitude`, `longitude`, etc. — even though the source had been updated to `number`. No source changes; this release just ensures `dist/` matches `src/`.
+- Added a `prepublishOnly` script (`npm run clean && npm run build`) so future publishes always ship a fresh build.
+
 ## [1.4.0] - 2026-05-15
 
 ### Added
@@ -85,7 +98,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Zero external runtime dependencies — p-queue and p-retry are bundled via Vite.
 - ES module only; native `fetch` API; TypeScript declarations included.
 
-[Unreleased]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.4.0...HEAD
+[Unreleased]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.4.2...HEAD
+[1.4.2]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.4.1...v1.4.2
+[1.4.1]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.4.0...v1.4.1
 [1.4.0]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/bmlt-enabled/bmlt-query-client/compare/v1.1.0...v1.2.0

package/CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+TypeScript client library for querying BMLT (Basic Meeting List Tool) servers with built-in Nominatim geocoding. Published to NPM as `bmlt-query-client`. ESM-only, targets Node.js 20+ and modern browsers (ES2020).
+
+## Commands
+
+- **Build:** `npm run build` (Vite → `dist/app.js` single ES module + type declarations)
+- **Test:** `npm test` (Vitest, runs integration tests against live server `https://latest.aws.bmlt.app/main_server`)
+- **Lint:** `npm run lint`
+- **Format:** `npm run format` (Prettier) / `npm run format:check`
+- **Type check:** `npm run type-check` (tsc --noEmit)
+- **Clean:** `npm run clean` (removes dist/)
+
+Tests hit a real BMLT server and Nominatim, so they require network access and have 15-second timeouts.
+
+## Architecture
+
+**Entry point:** `src/index.ts` — re-exports everything from the modules below.
+
+**Core modules:**
+
+- `src/client/bmlt-client.ts` — **BmltClient** class. Main API client wrapping all BMLT endpoints (searchMeetings, getFormats, getServiceBodies, getChanges, getFieldKeys, getFieldValues, getNAWSDump, getServerInfo, getCoverageArea). Also provides geocoded search methods (searchMeetingsByAddress, searchMeetingsByCoordinates) and reverse geocoding.
+- `src/client/query-builder.ts` — **MeetingQueryBuilder** (fluent/chainable query API) and **QuickSearch** (convenience presets like today(), weekend(), virtual()). QueryBuilder holds a reference to BmltClient and delegates execution.
+- `src/services/geocoding.ts` — **GeocodingService** wrapping Nominatim OpenStreetMap API with rate limiting (p-queue) and retry logic (p-retry).
+- `src/utils/url-builder.ts` — URL construction and parameter validation for BMLT API calls.
+- `src/utils/errors.ts` — **BmltQueryError** custom error class with BmltErrorType enum, plus ErrorFactory, ErrorHandler, and RetryHandler utilities.
+- `src/types/` — TypeScript interfaces and enums: BmltDataFormat, BmltEndpoint, Weekday (1-7, Sun-Sat), VenueType (1-3), SortKey, Language, request/response interfaces.
+
+**Build output:** Vite bundles all dependencies (including p-queue, p-retry) into a single `dist/app.js` with no externals, plus `dist/app.d.ts` type declarations.
+
+## Code Style
+
+- Strict TypeScript (`strict: true` in tsconfig)
+- Prettier: single quotes, trailing commas (es5), 100 char print width, 2-space indent, no semicolons optional (semi: true)
+- ESLint: prefer-const, no-var enforced

package/dist/app.d.ts

@@ -304,21 +304,27 @@ export declare interface Coordinates {
 /**
  * Count unique groups across a list of meetings.
  *
- * A "group" is identified by the combination of service body and meeting name
- * (case-insensitive, trimmed), so multiple weekly meetings of the same group
- * count once.
+ * A "group" is identified by the combination of service body, meeting name
+ * (case-insensitive, trimmed), and meeting location — physical coordinates
+ * for in-person/hybrid (venue_type !== 2), or the virtual meeting link plus
+ * additional info for virtual (venue_type === 2). Multiple weekly meetings of
+ * the same group count once; two distinct groups that happen to share a name
+ * but meet at different locations count separately. Matches the long-standing
+ * "group_id" definition used by crouton.
+ *
+ * Meetings missing a service body or name are skipped.
  */
 export declare function countUniqueGroups(meetings: Meeting[]): number;
 
 export declare interface CoverageArea {
-    /** Northwest corner longitude as a numeric string */
-    nw_corner_longitude: string;
-    /** Northwest corner latitude as a numeric string */
-    nw_corner_latitude: string;
-    /** Southeast corner longitude as a numeric string */
-    se_corner_longitude: string;
-    /** Southeast corner latitude as a numeric string */
-    se_corner_latitude: string;
+    /** Northwest corner longitude */
+    nw_corner_longitude: number;
+    /** Northwest corner latitude */
+    nw_corner_latitude: number;
+    /** Southeast corner longitude */
+    se_corner_longitude: number;
+    /** Southeast corner latitude */
+    se_corner_latitude: number;
 }
 
 /** A single meeting paired with the index of the list it came from */
@@ -596,10 +602,10 @@ export declare enum Language {
 export declare interface Meeting {
     /** Meeting ID */
     id_bigint: string;
-    /** Weekday (1-7) as a numeric string */
-    weekday_tinyint: string;
-    /** Venue type (1=In-person, 2=Virtual, 3=Hybrid) as a numeric string */
-    venue_type: string;
+    /** Weekday (1=Sunday, 7=Saturday) */
+    weekday_tinyint: number;
+    /** Venue type (1=In-person, 2=Virtual, 3=Hybrid) */
+    venue_type: number;
     /** Start time (24-hour format HH:MM:SS) */
     start_time: string;
     /** Duration time (HH:MM:SS) */
@@ -628,12 +634,12 @@ export declare interface Meeting {
     location_sub_province?: string;
     /** Location nation */
     location_nation?: string;
-    /** Latitude as a numeric string */
-    latitude: string;
-    /** Longitude as a numeric string */
-    longitude: string;
-    /** Published status (0=unpublished, 1=published) as a numeric string */
-    published: string;
+    /** Latitude */
+    latitude: number;
+    /** Longitude */
+    longitude: number;
+    /** Published status (0=unpublished, 1=published) */
+    published: number;
     /** Email contact */
     email_contact?: string;
     /** World Committee Code */
@@ -678,10 +684,10 @@ export declare interface Meeting {
     admin_notes?: string;
     /** Root server URI (for aggregator mode) */
     root_server_uri?: string;
-    /** Distance from search point in km as a numeric string (when using geographic search; may be empty string otherwise) */
-    distance_in_km?: string;
-    /** Distance from search point in miles as a numeric string (when using geographic search; may be empty string otherwise) */
-    distance_in_miles?: string;
+    /** Distance from search point in km (undefined when not a geographic search) */
+    distance_in_km?: number;
+    /** Distance from search point in miles (undefined when not a geographic search) */
+    distance_in_miles?: number;
 }
 
 export declare class MeetingQueryBuilder {
@@ -1043,18 +1049,18 @@ export declare interface SearchResultsParams extends BaseSearchParams {
 export declare interface ServerInfo {
     /** Server version (e.g. "4.2.0") */
     version: string;
-    /** Server version as integer string (e.g. "4002000") */
-    versionInt: string;
+    /** Server version as integer (e.g. 4002000) */
+    versionInt: number;
     /** Supported languages, comma-separated (e.g. "da,de,el,en,es") */
     langs: string;
     /** Native language code (e.g. "en") */
     nativeLang: string;
-    /** Map center longitude as a numeric string */
-    centerLongitude: string;
-    /** Map center latitude as a numeric string */
-    centerLatitude: string;
-    /** Default map zoom level as a numeric string */
-    centerZoom: string;
+    /** Map center longitude */
+    centerLongitude: number;
+    /** Map center latitude */
+    centerLatitude: number;
+    /** Default map zoom level */
+    centerZoom: number;
     /** Default meeting duration (HH:MM:SS) */
     defaultDuration: string;
     /** Region bias for geocoding (e.g. "us") */
@@ -1063,10 +1069,10 @@ export declare interface ServerInfo {
     charSet: string;
     /** Distance units ("mi" or "km") */
     distanceUnits: string;
-    /** Semantic admin enabled flag as a numeric string ("0" or "1") */
-    semanticAdmin: string;
-    /** Number of changes tracked per meeting as a numeric string */
-    changesPerMeeting: string;
+    /** Semantic admin enabled flag (0 or 1) */
+    semanticAdmin: number;
+    /** Number of changes tracked per meeting */
+    changesPerMeeting: number;
     /** Comma-separated list of states/provinces with meetings */
     meeting_states_and_provinces: string;
     /** Comma-separated list of counties/sub-provinces with meetings */