@chaosity/location-client-react 0.1.12 → 0.1.18

package/README.md

@@ -33,7 +33,11 @@ export async function getLocationConfig() {
 import { LocationClientProvider } from '@chaosity/location-client-react'
 import { getLocationConfig } from './actions/location'
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
   return (
     <LocationClientProvider getConfig={getLocationConfig}>
       {children}
@@ -54,7 +58,7 @@ function SearchComponent() {
   const searchPlaces = async (query: string) => {
     if (!client) return
     const response = await client.send(
-      new SuggestCommand({ QueryText: query, MaxResults: 5 })
+      new SuggestCommand({ QueryText: query, MaxResults: 5 }),
     )
     return response.ResultItems
   }
@@ -83,7 +87,9 @@ function MapComponent() {
   useMapLanguage(mapInstance, language)
 
   useEffect(() => {
-    const map = new maplibregl.Map({ /* ... */ })
+    const map = new maplibregl.Map({
+      /* ... */
+    })
     map.once('load', () => setMapInstance(map))
     return () => map.remove()
   }, [])
@@ -109,15 +115,13 @@ function MapComponent() {
 Provides the location client and automatic token refresh to all child components.
 
 ```tsx
-<LocationClientProvider
-  getConfig={getLocationConfig}
-  refreshBuffer={60}
->
+<LocationClientProvider getConfig={getLocationConfig} refreshBuffer={60}>
   {children}
 </LocationClientProvider>
 ```
 
 **Props:**
+
 - `getConfig` — Async function that returns `{ apiUrl: string, token: string, expiresAt?: number }`. Called on init and whenever the token needs refreshing.
 - `refreshBuffer` (optional, default: `60`) — Seconds before token expiry to proactively refresh. Prevents mid-request expiration.
 - `children` — Child components.
@@ -131,6 +135,7 @@ const { client, getToken, loading, error } = useLocationClient()
 ```
 
 **Returns:**
+
 - `client` (`GeoPlacesClient | null`) — The location client instance. Automatically refreshes the token before each `send()` call if needed.
 - `getToken` (`() => string | undefined`) — Returns the current token. Useful for direct API calls (e.g., map style fetch).
 - `loading` (`boolean`) — Whether the client is initializing.
@@ -155,7 +160,10 @@ No manual token management needed. The `client` always uses a valid token.
 'use client'
 
 import { useEffect, useRef, useState } from 'react'
-import { useLocationClient, useMapLanguage } from '@chaosity/location-client-react'
+import {
+  useLocationClient,
+  useMapLanguage,
+} from '@chaosity/location-client-react'
 import {
   GeoPlaces,
   fetchMapStyle,
@@ -178,7 +186,6 @@ export default function MapComponent() {
 
   useEffect(() => {
     if (!mapContainer.current || map.current || loading || !client) return
-
     ;(async () => {
       // Fetch style with terrain, 3D buildings, and language baked into the descriptor
       const style = await fetchMapStyle(API_URL, 'Standard', getToken, {
@@ -197,8 +204,14 @@ export default function MapComponent() {
         transformRequest: createTransformRequest(API_URL, getToken),
       })
 
-      instance.addControl(new maplibregl.NavigationControl({ visualizePitch: true }), 'top-right')
-      instance.addControl(new maplibregl.TerrainControl({ source: 'amazon' }), 'top-right')
+      instance.addControl(
+        new maplibregl.NavigationControl({ visualizePitch: true }),
+        'top-right',
+      )
+      instance.addControl(
+        new maplibregl.TerrainControl({ source: 'amazon' }),
+        'top-right',
+      )
 
       const geoPlaces = new GeoPlaces(client, instance)
       const geocoder = new MaplibreGeocoder(geoPlaces, {
@@ -237,6 +250,7 @@ useMapLanguage(map: MapLike | null, language: string): void
 ```
 
 **Parameters:**
+
 - `map` — MapLibre Map instance, or `null` while the map is initializing.
 - `language` — ISO 639-1 language code (e.g. `'en'`, `'fr'`, `'de'`, `'ja'`, `'zh'`, `'ar'`).
 
@@ -259,7 +273,7 @@ function MyComponent() {
 
   const search = async () => {
     const response = await client!.send(
-      new SuggestCommand({ QueryText: 'Vancouver', MaxResults: 5 })
+      new SuggestCommand({ QueryText: 'Vancouver', MaxResults: 5 }),
     )
     return response.ResultItems
   }
@@ -283,7 +297,7 @@ import type { SuggestCommandOutput } from '@aws-sdk/client-geo-places'
 
 const { client } = useLocationClient()
 const response: SuggestCommandOutput = await client!.send(
-  new SuggestCommand({ QueryText: 'Vancouver' })
+  new SuggestCommand({ QueryText: 'Vancouver' }),
 )
 ```
 

package/dist/hooks/useMapLanguage.d.ts

@@ -1,12 +1,4 @@
-/**
- * Minimal interface describing the MapLibre Map methods used by this hook.
- * Using a structural type avoids maplibre-gl version conflicts between packages.
- */
-interface MapLike {
-    isStyleLoaded(): boolean | void;
-    on(event: string, listener: (...args: unknown[]) => void): void;
-    off(event: string, listener: (...args: unknown[]) => void): void;
-}
+import type { MapLike } from '@chaosity/location-client';
 /**
  * React hook that keeps map label language in sync with the `language` prop.
  *
@@ -22,4 +14,3 @@ interface MapLike {
  * useMapLanguage(mapInstance, language)
  */
 export declare function useMapLanguage(map: MapLike | null, language: string): void;
-export {};

package/dist/hooks/useMapLanguage.js

@@ -1,6 +1,6 @@
 'use client';
-import { useEffect } from 'react';
 import { applyMapLanguage } from '@chaosity/location-client';
+import { useEffect } from 'react';
 /**
  * React hook that keeps map label language in sync with the `language` prop.
  *
@@ -19,7 +19,6 @@ export function useMapLanguage(map, language) {
     useEffect(() => {
         if (!map)
             return;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const applyFn = () => applyMapLanguage(map, language);
         if (map.isStyleLoaded()) {
             applyFn();

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { LocationClientProvider, useLocationClient } from './provider/LocationClientProvider';
+export { LocationClientProvider, useLocationClient, } from './provider/LocationClientProvider';
 export type { LocationClientProviderProps } from './provider/LocationClientProvider';
 export { useMapLanguage } from './hooks/useMapLanguage';

package/dist/index.js

@@ -1,2 +1,2 @@
-export { LocationClientProvider, useLocationClient } from './provider/LocationClientProvider';
+export { LocationClientProvider, useLocationClient, } from './provider/LocationClientProvider';
 export { useMapLanguage } from './hooks/useMapLanguage';

package/dist/provider/LocationClientProvider.d.ts

@@ -1,5 +1,6 @@
+import type { ClientConfig } from '@chaosity/location-client';
+import { GeoPlacesClient } from '@chaosity/location-client';
 import type { ReactNode } from 'react';
-import { GeoPlacesClient, ClientConfig } from '@chaosity/location-client';
 interface LocationClientContextValue {
     client: GeoPlacesClient | null;
     getToken: () => string | undefined;
@@ -14,6 +15,6 @@ export interface LocationClientProviderProps {
     /** Seconds before expiry to proactively refresh (default: 60) */
     refreshBuffer?: number;
 }
-export declare function LocationClientProvider({ children, getConfig, refreshBuffer }: LocationClientProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function LocationClientProvider({ children, getConfig, refreshBuffer, }: LocationClientProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useLocationClient(): LocationClientContextValue;
 export {};

package/dist/provider/LocationClientProvider.js

@@ -1,11 +1,11 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useState, useRef, useCallback } from 'react';
 import { GeoPlacesClient } from '@chaosity/location-client';
 import debug from 'debug';
+import { createContext, useCallback, useContext, useEffect, useRef, useState, } from 'react';
 const log = debug('location-client-react:provider');
 const LocationClientContext = createContext(undefined);
-export function LocationClientProvider({ children, getConfig, refreshBuffer = 60 }) {
+export function LocationClientProvider({ children, getConfig, refreshBuffer = 60, }) {
     const [client, setClient] = useState(null);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
@@ -26,7 +26,7 @@ export function LocationClientProvider({ children, getConfig, refreshBuffer = 60
     const isTokenExpired = useCallback(() => {
         if (!expiresAtRef.current)
             return true;
-        return Date.now() >= (expiresAtRef.current - refreshBuffer * 1000);
+        return Date.now() >= expiresAtRef.current - refreshBuffer * 1000;
     }, [refreshBuffer]);
     // Refreshes the token exactly once even when called concurrently.
     // All concurrent callers await the same in-flight promise — same pattern as
@@ -46,7 +46,7 @@ export function LocationClientProvider({ children, getConfig, refreshBuffer = 60
         refreshPromiseRef.current = (async () => {
             const cfg = await getConfigRef.current();
             tokenRef.current = cfg.token;
-            expiresAtRef.current = cfg.expiresAt ?? (Date.now() + 900000);
+            expiresAtRef.current = cfg.expiresAt ?? Date.now() + 900000;
             const newExpiry = Math.floor((expiresAtRef.current - Date.now()) / 1000);
             log('Token refreshed (expires in %ds)', newExpiry);
         })();
@@ -71,16 +71,21 @@ export function LocationClientProvider({ children, getConfig, refreshBuffer = 60
     // transparently without recreating the client or causing re-renders.
     useEffect(() => {
         log('Initializing LocationClientProvider');
-        getConfigRef.current()
+        getConfigRef
+            .current()
             .then((cfg) => {
             tokenRef.current = cfg.token;
-            expiresAtRef.current = cfg.expiresAt ?? (Date.now() + 900000);
+            expiresAtRef.current = cfg.expiresAt ?? Date.now() + 900000;
             // GeoPlacesClient.send() calls getToken() synchronously for the token value,
             // but token refresh is async. We create a thin send wrapper that:
             // 1. awaits ensureValidToken (via ref — always latest, race-safe)
             // 2. delegates to baseClient which reads the now-fresh token from getToken()
             // The client instance is created once and never recreated on token refresh.
-            const baseClient = new GeoPlacesClient({ apiUrl: cfg.apiUrl, token: cfg.token, getToken });
+            const baseClient = new GeoPlacesClient({
+                apiUrl: cfg.apiUrl,
+                token: cfg.token,
+                getToken,
+            });
             const wrappingClient = Object.create(baseClient);
             wrappingClient.send = async (command) => {
                 await ensureValidTokenRef.current();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaosity/location-client-react",
-  "version": "0.1.12",
+  "version": "0.1.18",
   "description": "React bindings for Chaosity Location Service client",
   "type": "module",
   "main": "dist/index.js",
@@ -8,6 +8,9 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "lint": "eslint . && prettier --check .",
+    "lint:fix": "eslint --fix . && prettier --write .",
+    "format": "prettier --write .",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "prepublishOnly": "npm run build",
@@ -44,16 +47,21 @@
     }
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.0.0",
     "@types/debug": "^4.1.12",
     "@types/react": "^19.0.0",
     "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^10.1.0",
     "happy-dom": "^17.0.0",
     "husky": "^9.0.0",
     "maplibre-gl": "^5.0.0",
+    "prettier": "^3.8.1",
+    "prettier-plugin-organize-imports": "^4.3.0",
     "react": "^19.0.0",
     "typescript": "^5.0.0",
+    "typescript-eslint": "^8.57.1",
     "vitest": "^3.0.0"
   },
   "publishConfig": {