@geolonia/geonicdb-sdk 0.11.1 → 0.12.0

package/react/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/sdk/react/index.ts", "../../../src/sdk/react/hooks.ts", "../../../src/sdk/react/GeonicDbMap.tsx"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Geolonia Inc.\n// See LICENSE in src/sdk/ for full license text.\n\n/**\n * @geolonia/geonicdb-sdk/react \u2014 React hooks and map component\n *\n * Requires React 18 or 19 as an optional peer dependency.\n * Import only from this subpath to avoid pulling React into core consumers.\n */\nexport { useLdEntities, useTemporalData } from './hooks.js';\nexport { GeonicDbMap } from './GeonicDbMap.js';\nexport type { GeonicDbMapProps } from './GeonicDbMap.js';\nexport type {\n  LdEntity,\n  LdAttribute,\n  LdProperty,\n  LdGeoProperty,\n  LdRelationship,\n  LdQueryOptions,\n  NgsiEntity,\n  NgsiAttribute,\n  GeoJsonPoint,\n  GeoJsonPolygon,\n  GeoJsonGeometry,\n} from './types.js';\n", "// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Geolonia Inc.\n// See LICENSE in src/sdk/ for full license text.\n\n/**\n * NGSI-LD React hooks \u2014 built on top of GeonicDB SDK core.\n */\n\nimport { useState, useEffect, useCallback, useRef } from 'react';\nimport type GeonicDB from '../index.js';\nimport type { GetEntitiesParams, GetTemporalEntitiesParams } from '../types.js';\nimport type { LdEntity, LdQueryOptions } from './types.js';\n\n/**\n * Fetch NGSI-LD entities using the GeonicDB SDK client.\n *\n * The official SDK core handles DPoP / auth transparently.\n */\nexport function useLdEntities(\n  client: GeonicDB,\n  options?: LdQueryOptions,\n): {\n  entities: LdEntity[];\n  loading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const [entities, setEntities] = useState<LdEntity[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // \u30EA\u30AF\u30A8\u30B9\u30C8\u4E16\u4EE3\u30AB\u30A6\u30F3\u30BF\u3002deps \u5909\u5316\u30FBrefetch\u30FB\u30A2\u30F3\u30DE\u30A6\u30F3\u30C8\u6642\u306B\u5897\u3084\u3057\u3001\n  // \u53E4\u3044 in-flight \u30EC\u30B9\u30DD\u30F3\u30B9\u304C\u65B0\u3057\u3044\u7D50\u679C\u3092\u4E0A\u66F8\u304D\u3059\u308B race \u3068\u3001\n  // \u30A2\u30F3\u30DE\u30A6\u30F3\u30C8\u5F8C\u306E setState \u3092\u9632\u3050\u3002\n  const genRef = useRef(0);\n\n  const params: GetEntitiesParams = {};\n  if (options?.type) params.type = options.type;\n  if (options?.limit) params.limit = options.limit;\n  if (options?.attrs) params.attrs = options.attrs.join(',');\n  if (options?.q) params.q = options.q;\n  if (options?.scopeQ) params.scopeQ = options.scopeQ;\n\n  const paramsKey = JSON.stringify(params);\n\n  const fetchEntities = useCallback(async () => {\n    const gen = ++genRef.current;\n    setLoading(true);\n    setError(null);\n    try {\n      const data = await client.getEntities(params);\n      if (genRef.current === gen) setEntities(data as LdEntity[]);\n    } catch (err) {\n      if (genRef.current === gen) setError(err instanceof Error ? err : new Error('Unknown error'));\n    } finally {\n      if (genRef.current === gen) setLoading(false);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [client, paramsKey]);\n\n  useEffect(() => {\n    void fetchEntities();\n    // \u30A2\u30F3\u30DE\u30A6\u30F3\u30C8 / deps \u5909\u5316\u3067 in-flight \u3092\u7121\u52B9\u5316\u3059\u308B\n    return () => {\n      genRef.current++;\n    };\n  }, [fetchEntities]);\n\n  return { entities, loading, error, refetch: fetchEntities };\n}\n\n/**\n * Fetch NGSI-LD temporal (time-series) data using the GeonicDB SDK client.\n */\nexport function useTemporalData(\n  client: GeonicDB | undefined,\n  options: GetTemporalEntitiesParams & { enabled?: boolean },\n): {\n  data: Record<string, unknown>[];\n  loading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const [data, setData] = useState<Record<string, unknown>[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // useLdEntities \u3068\u540C\u3058\u304F\u3001\u53E4\u3044 in-flight \u30EC\u30B9\u30DD\u30F3\u30B9\u3068\u30A2\u30F3\u30DE\u30A6\u30F3\u30C8\u5F8C setState \u3092\u9632\u3050\u4E16\u4EE3\u30AB\u30A6\u30F3\u30BF\u3002\n  const genRef = useRef(0);\n\n  const enabled = options.enabled !== false;\n\n  // Serialize all options as a stable cache key so that any param change triggers re-fetch.\n  const optionsKey = JSON.stringify(options);\n\n  const fetchData = useCallback(async () => {\n    const gen = ++genRef.current;\n    if (!enabled || !client) {\n      setData([]);\n      return;\n    }\n\n    setLoading(true);\n    setError(null);\n    try {\n      if (options.id) {\n        const entity = await client.getTemporalEntity(options.id);\n        if (genRef.current === gen) setData([entity]);\n      } else {\n        const entities = await client.getTemporalEntities(options);\n        if (genRef.current === gen) setData(entities);\n      }\n    } catch (err) {\n      if (genRef.current === gen) setError(err instanceof Error ? err : new Error('Unknown error'));\n    } finally {\n      if (genRef.current === gen) setLoading(false);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [client, optionsKey]);\n\n  useEffect(() => {\n    void fetchData();\n    // \u30A2\u30F3\u30DE\u30A6\u30F3\u30C8 / deps \u5909\u5316\u3067 in-flight \u3092\u7121\u52B9\u5316\u3059\u308B\n    return () => {\n      genRef.current++;\n    };\n  }, [fetchData]);\n\n  return { data, loading, error, refetch: fetchData };\n}\n", "// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Geolonia Inc.\n// See LICENSE in src/sdk/ for full license text.\n\n/**\n * GeonicDbMap \u2014 Geolonia embed-based map component for GeonicDB entities.\n *\n * Ported from geonicdb-demo-app/packages/shared/src/components/GeonicDbMap.tsx.\n * @geolonia/embed is an optional peer dependency (required only when using this component).\n */\n\nimport { useEffect, useRef, useCallback, type CSSProperties } from 'react';\nimport type { Map as EmbedMap, Marker as EmbedMarker } from '@geolonia/embed';\nimport type { LdEntity, NgsiEntity, GeoJsonPoint } from './types.js';\n\nexport interface GeonicDbMapProps {\n  center?: [number, number];\n  zoom?: number;\n  styleUrl?: string;\n  /** Entities to display. Accepts both LdEntity (NGSI-LD) and NgsiEntity (NGSIv2). */\n  entities?: (LdEntity | NgsiEntity)[];\n  onEntityClick?: (entity: LdEntity | NgsiEntity) => void;\n  onMapClick?: (lngLat: [number, number]) => void;\n  className?: string;\n  style?: CSSProperties;\n  showPopups?: boolean;\n  fitToMarkers?: boolean;\n}\n\nconst DEFAULT_STYLE = 'geolonia/basic';\n\nfunction escapeHtml(s: string): string {\n  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;');\n}\n\nfunction getEntityLocation(entity: LdEntity | NgsiEntity): [number, number] | null {\n  const location = entity.location;\n  if (!location || typeof location === 'string') return null;\n\n  // NGSI-LD GeoProperty normalized: { type: \"GeoProperty\", value: { type: \"Point\", coordinates: [...] } }\n  const ldLoc = location as { type?: string; value?: GeoJsonPoint };\n  if (ldLoc.type === 'GeoProperty' && ldLoc.value?.type === 'Point' && Array.isArray(ldLoc.value.coordinates)) {\n    return ldLoc.value.coordinates;\n  }\n\n  // NGSIv2 normalized: { type: \"geo:json\", value: { type: \"Point\", coordinates: [...] } }\n  const v2Loc = location as { type?: string; value?: GeoJsonPoint };\n  if (v2Loc.value?.type === 'Point' && Array.isArray(v2Loc.value.coordinates)) {\n    return v2Loc.value.coordinates;\n  }\n\n  // keyValues: { type: \"Point\", coordinates: [...] }\n  const kv = location as unknown as GeoJsonPoint;\n  if (kv.type === 'Point' && Array.isArray(kv.coordinates)) {\n    return kv.coordinates;\n  }\n\n  return null;\n}\n\nfunction getMarkerColor(entityType: string): string {\n  const colors: Record<string, string> = {\n    Room: '#3b82f6',\n    ParkingSpot: '#22c55e',\n    AirQualitySensor: '#f59e0b',\n    TrafficFlow: '#ef4444',\n    EnvironmentSensor: '#8b5cf6',\n    EnvSensor: '#8b5cf6',\n    TemperatureSensor: '#f97316',\n    GeoFeature: '#0ea5e9',\n  };\n  return colors[entityType] ?? '#6b7280';\n}\n\nexport function GeonicDbMap({\n  center = [139.7671, 35.6812],\n  zoom = 13,\n  styleUrl,\n  entities = [],\n  onEntityClick,\n  onMapClick,\n  className = '',\n  style: customStyle,\n  showPopups = true,\n  fitToMarkers = false,\n}: GeonicDbMapProps) {\n  const mapContainerRef = useRef<HTMLDivElement>(null);\n  const mapRef = useRef<EmbedMap | null>(null);\n  const markersRef = useRef<EmbedMarker[]>([]);\n  const mapLoadedRef = useRef(false);\n  const pendingUpdateRef = useRef(false);\n\n  useEffect(() => {\n    if (!mapContainerRef.current) return;\n\n    mapLoadedRef.current = false;\n\n    // Dynamic import to avoid bundling @geolonia/embed for non-map consumers.\n    // @geolonia/embed is an optional peer dependency.\n    void import('@geolonia/embed').then(({ Map: GeoMap }) => {\n      if (!mapContainerRef.current) return;\n\n      const map = new GeoMap({\n        container: mapContainerRef.current,\n        style: styleUrl ?? DEFAULT_STYLE,\n        center,\n        zoom,\n      });\n\n      mapRef.current = map;\n\n      const onReady = () => {\n        mapLoadedRef.current = true;\n        if (pendingUpdateRef.current) {\n          pendingUpdateRef.current = false;\n          window.dispatchEvent(new CustomEvent('geonicdb-map-ready'));\n        }\n      };\n\n      map.on('load', onReady);\n      map.once('idle', onReady);\n\n      if (onMapClick) {\n        (map as unknown as { on: (e: string, cb: (e: { lngLat: { lng: number; lat: number } }) => void) => void }).on('click', (e) => {\n          onMapClick([e.lngLat.lng, e.lngLat.lat]);\n        });\n      }\n    });\n\n    return () => {\n      if (mapRef.current) {\n        mapRef.current.remove();\n        mapRef.current = null;\n        mapLoadedRef.current = false;\n      }\n    };\n    // center/zoom are intentionally excluded: the map is initialized once per styleUrl change.\n    // Subsequent center/zoom updates should use imperative map methods (flyTo/jumpTo),\n    // not re-mount the map. Markers/entities are updated via the doUpdate effect below.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [styleUrl]);\n\n  const doUpdate = useCallback(() => {\n    const map = mapRef.current;\n    if (!map) return;\n\n    markersRef.current.forEach((marker) => marker.remove());\n    markersRef.current = [];\n\n    void import('@geolonia/embed').then(({ Marker, geolonia }) => {\n      entities.forEach((entity) => {\n        const coords = getEntityLocation(entity);\n        if (!coords) return;\n\n        const color = getMarkerColor(entity.type);\n        const el = document.createElement('div');\n        el.style.cssText = `width:24px;height:24px;background-color:${color};border:2px solid white;border-radius:50%;cursor:pointer;box-shadow:0 2px 4px rgba(0,0,0,0.3);`;\n\n        const marker = new Marker({ element: el }).setLngLat(coords).addTo(map);\n\n        if (showPopups && geolonia?.Popup) {\n          const popup = new geolonia.Popup({ closeButton: false, closeOnClick: false, offset: 15 })\n            .setHTML(`<div style=\"font-family:sans-serif;font-size:12px;\"><strong>${escapeHtml(entity.id)}</strong><br/><span style=\"color:#666\">${escapeHtml(entity.type)}</span></div>`);\n          el.addEventListener('mouseenter', () => { marker.setPopup(popup); popup.addTo(map); });\n          el.addEventListener('mouseleave', () => { popup.remove(); });\n        }\n\n        if (onEntityClick) {\n          el.addEventListener('click', (e) => { e.stopPropagation(); onEntityClick(entity); });\n        }\n\n        markersRef.current.push(marker);\n      });\n\n      if (fitToMarkers && markersRef.current.length > 0) {\n        const allCoords = entities.map(getEntityLocation).filter((c): c is [number, number] => c !== null);\n        if (allCoords.length === 1 && allCoords[0]) {\n          map.flyTo({ center: allCoords[0], zoom: 14 });\n        } else if (allCoords.length > 1) {\n          const bounds = allCoords.reduce(\n            (b, coord) => [[Math.min(b[0][0], coord[0]), Math.min(b[0][1], coord[1])], [Math.max(b[1][0], coord[0]), Math.max(b[1][1], coord[1])]] as [[number, number], [number, number]],\n            [[allCoords[0]![0], allCoords[0]![1]], [allCoords[0]![0], allCoords[0]![1]]] as [[number, number], [number, number]]\n          );\n          map.fitBounds(bounds, { padding: 30 });\n        }\n      }\n    });\n  }, [entities, onEntityClick, showPopups, fitToMarkers]);\n\n  useEffect(() => {\n    if (mapLoadedRef.current) {\n      doUpdate();\n    } else {\n      pendingUpdateRef.current = true;\n      const handler = () => doUpdate();\n      window.addEventListener('geonicdb-map-ready', handler, { once: true });\n      return () => window.removeEventListener('geonicdb-map-ready', handler);\n    }\n  }, [doUpdate]);\n\n  const defaultStyle: CSSProperties = { width: '100%', height: '100%', minHeight: '400px' };\n\n  return (\n    <div\n      ref={mapContainerRef}\n      className={className}\n      style={{ ...defaultStyle, ...customStyle }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["import_react"]
+}

package/react/index.d.ts

@@ -0,0 +1,551 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { CSSProperties } from 'react';
+
+/**
+ * Copyright (c) 2026 Geolonia Inc.
+ * Released under the MIT License. See src/sdk/LICENSE for details.
+ */
+/** Options for the GeonicDB SDK constructor. */
+export interface GeonicDBOptions {
+	/** API key (or use data-api-key attribute on script tag) */
+	apiKey?: string;
+	/** Tenant name (or use data-tenant attribute on script tag) */
+	tenant?: string;
+	/** API base URL (auto-detected from script src if omitted) */
+	baseUrl?: string;
+	/** WebSocket endpoint URL (auto-detected from baseUrl if omitted) */
+	wsEndpoint?: string;
+	/** Enable debug logging to console (default: false) */
+	debug?: boolean;
+	/**
+	 * Enable in-memory client-side cache with automatic ETag/If-None-Match
+	 * handling and request deduplication. (Phase A, default: true)
+	 */
+	cache?: boolean;
+	/**
+	 * Maximum number of cached entries (LRU eviction beyond this size).
+	 * Only meaningful when `cache` is enabled. Default: 1000.
+	 */
+	cacheMaxEntries?: number;
+	/**
+	 * #1105: Anonymous mode. When true, the SDK skips token acquisition and
+	 * sends requests without an `Authorization` header. The server treats
+	 * such requests as `role: 'anonymous'` and lets the XACML policy engine
+	 * decide whether to permit them.
+	 *
+	 * - Cannot be combined with `apiKey` (constructor throws).
+	 * - `login()` / `setCredentials()` switches the SDK out of anonymous mode
+	 *   for subsequent requests.
+	 * - `logout()` reverts to anonymous mode.
+	 * - WebSocket `connect()` is not supported in anonymous mode and throws.
+	 */
+	anonymous?: boolean;
+}
+/** Options for the SDK polling helper. */
+export interface PollOptions<T = unknown> {
+	/** Polling interval in milliseconds (default: 5000). */
+	interval?: number;
+	/** Called when fresh data is received from the server (200). */
+	onData?: (data: T) => void;
+	/** Called when the server responded 304 (no change since last poll). */
+	onNoChange?: () => void;
+	/** Called on transport / HTTP errors. Polling continues unless the handler stops it. */
+	onError?: (error: unknown) => void;
+}
+/** Handle returned by `db.poll(...)` to control the polling loop. */
+export interface PollHandle {
+	/** Stop the polling loop. Idempotent. */
+	stop(): void;
+}
+/** Options for setting credentials externally. */
+export interface CredentialsOptions {
+	/** Access token (JWT) */
+	token: string;
+	/** Token type — default: 'Bearer' */
+	tokenType?: "Bearer" | "DPoP";
+	/** Token lifetime in seconds (default: 3600) */
+	expiresIn?: number;
+	/** Refresh token for auto-renewal */
+	refreshToken?: string;
+}
+/** Credentials returned after a token refresh. */
+export interface RefreshedCredentials {
+	/** New access token */
+	token: string;
+	/** Token type */
+	tokenType: string;
+	/** Token lifetime in seconds */
+	expiresIn: number;
+	/** New refresh token */
+	refreshToken: string;
+}
+/**
+ * Parameters for querying entities.
+ *
+ * NGSI-LD 1.6 §5.7.2 Query Entities が定める主要パラメータを網羅する (#1132)。
+ * 以前はサーバ側が georel / scopeQ / attrs / pick / omit / lang などを実装
+ * しているのに SDK 側で型と URL builder が `type / limit / offset / q` の
+ * 4 つしか持たず、`db.request()` に逃げる必要があった。
+ */
+export interface GetEntitiesParams {
+	/** Entity type filter */
+	type?: string;
+	/** Max results */
+	limit?: number;
+	/** Pagination offset */
+	offset?: number;
+	/** NGSI-LD query expression */
+	q?: string;
+	/** NGSI-LD scope query expression (`/foo`, `/foo/#`, `/foo/+`, `;` で OR) */
+	scopeQ?: string;
+	/** Geo-relation: `near`, `within`, `contains`, `intersects`, `disjoint`, `equals` */
+	georel?: string;
+	/** Geometry type: `Point`, `Polygon`, `LineString`, ... */
+	geometry?: string;
+	/** Coordinates string (semicolon-delimited pairs or flat comma-separated) */
+	coordinates?: string;
+	/** Comma-separated attribute names to retrieve */
+	attrs?: string;
+	/** Comma-separated attribute names to keep (alternative to attrs) */
+	pick?: string;
+	/** Comma-separated attribute names to remove */
+	omit?: string;
+	/** Language tag for LanguageProperty filtering */
+	lang?: string;
+	/** Order by field */
+	orderBy?: string;
+	/** Order direction: `asc` (default) or `desc` */
+	orderDirection?: "asc" | "desc";
+	/** Sort points by distance from a `near` query */
+	orderByDistance?: boolean;
+	/** Whether the response should include a count (server returns `NGSILD-Results-Count` header) */
+	count?: boolean;
+	/** GeoProperty key to use (default `location`) */
+	geoproperty?: string;
+	/**
+	 * NGSI-LD representation options (`options` query param)。カンマ区切りで複数指定可。
+	 * - `sysAttrs` — システム属性 (`createdAt` / `modifiedAt`) を含める
+	 * - `keyValues` — 簡易表現 (属性を値だけに圧縮)
+	 * - `concise` — concise 表現
+	 * - `normalized` — 正規化表現 (デフォルト)
+	 *
+	 * 例: `'sysAttrs'`, `'keyValues,sysAttrs'`。
+	 */
+	options?: string;
+}
+/** Parameters for counting entities. */
+export interface CountEntitiesParams {
+	/** Entity type filter */
+	type?: string;
+	/** NGSI-LD query expression */
+	q?: string;
+	/** NGSI-LD scope query expression (#1132) */
+	scopeQ?: string;
+}
+/** Options for subscribing to entity events via WebSocket. */
+export interface SubscribeOptions {
+	/** Entity types to subscribe to */
+	entityTypes?: string[];
+	/** Entity ID regex pattern */
+	idPattern?: string;
+	/** NGSI-LD scope query expression (#1132). Server-side filter; only events whose entity scope matches are delivered. */
+	scopeQ?: string;
+}
+/** Entity event received via WebSocket. */
+export interface EntityEvent {
+	/** Event type */
+	type: "entityCreated" | "entityUpdated" | "entityDeleted";
+	/** Tenant name */
+	tenant: string;
+	/** Service path */
+	servicePath: string;
+	/** Entity ID */
+	entityId: string;
+	/** Entity type */
+	entityType: string;
+	/** Entity attributes */
+	data: Record<string, unknown>;
+	/** Complete NGSI-LD entity (id + type + attributes from data). Undefined when data is unavailable (e.g. some delete events). */
+	entity?: Record<string, unknown>;
+	/** Changed attribute names (update only) */
+	changedAttributes?: string[];
+	/** ISO 8601 timestamp */
+	timestamp: string;
+}
+/** Event fired when a reconnection attempt is starting. */
+export interface ReconnectingEvent {
+	/** Current reconnection attempt number */
+	attempt: number;
+	/** Delay in ms before this attempt */
+	delay: number;
+}
+/** Options for `db.login(...)`. */
+export interface LoginOptions {
+	/**
+	 * If true, keep the user signed in across page reloads by persisting the
+	 * session to IndexedDB. After a reload, call `db.restoreSession()` to
+	 * rehydrate the session; `db.logout()` clears the persisted entry.
+	 *
+	 * The session is bound to a non-extractable key (DPoP, RFC 9449) stored via
+	 * the structured clone algorithm — `extractable: false` is preserved, so the
+	 * key cannot be read back as JWK / PEM even with full DOM access. A token
+	 * leaked from localStorage stays unusable without this origin's IndexedDB.
+	 *
+	 * Default: false. Opt-out by design: shared-device flows should not enable
+	 * this. Has no effect when the runtime lacks Web Crypto — the session cannot
+	 * be sender-constrained, so it is not persisted.
+	 */
+	rememberSession?: boolean;
+}
+/** Response from the login endpoint. */
+export interface LoginResponse {
+	accessToken: string;
+	refreshToken: string;
+	expiresIn: number;
+	/**
+	 * Token scheme: `Bearer` (default) or `DPoP` when the session has been
+	 * sender-constrained via `/auth/dpop-bind` (RFC 9449). Optional for
+	 * backward compatibility with older server responses.
+	 */
+	tokenType?: "Bearer" | "DPoP";
+}
+/** Cache event payloads. */
+export interface CacheEvent {
+	/** Cache key (typically `${method}:${path}` form). */
+	key: string;
+	/** Resource path (without method prefix). */
+	path: string;
+}
+/** Map of event names to their payload types. */
+export interface GeonicDBEventMap {
+	entityCreated: EntityEvent;
+	entityUpdated: EntityEvent;
+	entityDeleted: EntityEvent;
+	open: undefined;
+	connected: undefined;
+	close: {
+		code: number;
+		reason: string;
+	};
+	disconnected: undefined;
+	reconnecting: ReconnectingEvent;
+	error: Error;
+	message: Record<string, unknown>;
+	tokenRefresh: RefreshedCredentials;
+	/** Fired when a request is served from the in-memory cache (304 received). */
+	cacheHit: CacheEvent;
+	/** Fired when a request misses cache and is fetched from the origin. */
+	cacheMiss: CacheEvent;
+	/** Fired when a cache entry is invalidated (e.g. by a WebSocket entity event). */
+	cacheInvalidated: CacheEvent;
+}
+/** Parameters for querying temporal entities. */
+export interface GetTemporalEntitiesParams {
+	/** Entity type filter */
+	type?: string;
+	/** Entity ID */
+	id?: string;
+	/** Entity ID pattern (regex) */
+	idPattern?: string;
+	/** Attribute names to retrieve */
+	attrs?: string;
+	/** NGSI-LD query expression */
+	q?: string;
+	/** Time property to use (observedAt, createdAt, modifiedAt) */
+	timeproperty?: string;
+	/** Start time (ISO 8601) */
+	timeAt?: string;
+	/** End time (ISO 8601) */
+	endTimeAt?: string;
+	/** Temporal relation (before, after, between) */
+	timerel?: string;
+	/** NGSI-LD scope query expression (#1132) */
+	scopeQ?: string;
+	/** Max results */
+	limit?: number;
+	/** Pagination offset */
+	offset?: number;
+	/**
+	 * NGSI-LD representation options (`options` query param)。カンマ区切りで複数指定可。
+	 * - `sysAttrs` — システム属性 (`createdAt` / `modifiedAt`) を含める
+	 * - `temporalValues` — 時系列を簡易配列表現で返す
+	 * - `aggregatedValues` — 集約表現で返す
+	 *
+	 * 例: `'sysAttrs'`, `'temporalValues'`。
+	 */
+	options?: string;
+}
+export type Listener<T> = (data: T) => void;
+declare class EventEmitter {
+	private _listeners;
+	on<K extends keyof GeonicDBEventMap>(event: K, callback: Listener<GeonicDBEventMap[K]>): this;
+	on(event: string, callback: Listener<unknown>): this;
+	off<K extends keyof GeonicDBEventMap>(event: K, callback?: Listener<GeonicDBEventMap[K]>): this;
+	off(event: string, callback?: Listener<unknown>): this;
+	protected emit<K extends keyof GeonicDBEventMap>(event: K, data?: GeonicDBEventMap[K]): void;
+	protected emit(event: string, data?: unknown): void;
+}
+declare class GeonicDB extends EventEmitter {
+	private _auth;
+	private _ws;
+	/**
+	 * Legacy callback for token refresh events.
+	 * Prefer `db.on('tokenRefresh', callback)` for new code.
+	 * @deprecated Use `db.on('tokenRefresh', callback)` instead.
+	 */
+	onTokenRefresh: ((creds: RefreshedCredentials) => void) | null;
+	constructor(options?: GeonicDBOptions);
+	/**
+	 * Drop every cached response. Useful in tests and on manual auth changes.
+	 *
+	 * Emits a `cacheInvalidated` event for each removed entry so listeners can
+	 * track explicit flushes (the WebSocket-driven auto-invalidation was removed
+	 * in #1060 to preserve the ETag/304 revalidation path; `clearCache()` is now
+	 * the only path that emits this event).
+	 */
+	clearCache(): void;
+	/**
+	 * Login with email and password.
+	 *
+	 * The session is sender-constrained with DPoP (RFC 9449) automatically and
+	 * transparently — there is no DPoP option to set. A token leaked from
+	 * storage (e.g. localStorage XSS) is therefore unusable from another origin.
+	 * On runtimes without Web Crypto, the SDK silently keeps a plain Bearer
+	 * session and login still succeeds.
+	 *
+	 * @example
+	 * ```ts
+	 * // Standard login — DPoP applied transparently when supported.
+	 * await db.login('user@example.com', 'password');
+	 *
+	 * // Keep the user signed in across page reloads (browser SPA UX).
+	 * await db.login('user@example.com', 'password', { rememberSession: true });
+	 * ```
+	 */
+	login(email: string, password: string, options?: LoginOptions): Promise<LoginResponse>;
+	/**
+	 * Rehydrate a session previously persisted via
+	 * `login(email, password, { rememberSession: true })`.
+	 *
+	 * Returns true if a session for this tenant was found and loaded; false
+	 * if there was no entry, IndexedDB is unavailable, or the persisted
+	 * session was malformed. Call this at app startup before deciding
+	 * whether to render the login form.
+	 *
+	 * @example
+	 * ```ts
+	 * const db = new GeonicDB({ baseUrl, tenant });
+	 * if (await db.restoreSession()) {
+	 *   // Session (tokens + non-extractable key) recovered — boot the app.
+	 * } else {
+	 *   // No session; show the login form.
+	 * }
+	 * ```
+	 */
+	restoreSession(): Promise<boolean>;
+	/**
+	 * Whether the SDK is currently operating in anonymous mode (no token held).
+	 * Returns true only when `anonymous: true` was passed to the constructor
+	 * AND no credentials have been set via `login()` / `setCredentials()`.
+	 */
+	isAnonymous(): boolean;
+	/**
+	 * Set credentials externally (e.g. from a login API response).
+	 * When tokenType is 'Bearer' with a refreshToken, DPoP/PoW is bypassed entirely.
+	 */
+	setCredentials(opts: CredentialsOptions): this;
+	/** Clear all credentials and disconnect. */
+	logout(): void;
+	/** Create a new entity. */
+	createEntity(entity: Record<string, unknown>): Promise<{
+		created: true;
+	}>;
+	/** Get a single entity by ID. */
+	getEntity(entityId: string): Promise<Record<string, unknown>>;
+	/** Query entities with optional filters. */
+	getEntities(params?: GetEntitiesParams): Promise<Record<string, unknown>[]>;
+	/**
+	 * Poll for entity list changes using ETag-based revalidation (#991 Phase A).
+	 *
+	 * The handle's `stop()` ends the loop. Each tick performs a normal
+	 * `getEntities()` call; the SDK's cache layer issues `If-None-Match`
+	 * automatically. The poll detects "no change" by comparing the previous
+	 * ETag with the response's ETag (the cache exposes the cached ETag on 304
+	 * replays as well, so the comparison stays valid in both 200 and 304
+	 * paths).
+	 *
+	 * @example
+	 * ```typescript
+	 * const handle = db.poll({ type: 'Room' }, {
+	 *   interval: 5000,
+	 *   onData: (rooms) => render(rooms),
+	 *   onNoChange: () => {},
+	 * });
+	 * // ...later
+	 * handle.stop();
+	 * ```
+	 */
+	poll(params: GetEntitiesParams | undefined, options: PollOptions<Record<string, unknown>[]>): PollHandle;
+	/** Count entities matching the given filters. */
+	count(params?: CountEntitiesParams): Promise<number>;
+	/** Update entity attributes (partial). */
+	updateEntity(entityId: string, attrs: Record<string, unknown>): Promise<{
+		updated: true;
+	}>;
+	/** Delete an entity. */
+	deleteEntity(entityId: string): Promise<{
+		deleted: true;
+	}>;
+	/** List all entity types. */
+	getTypes(): Promise<Record<string, unknown>[]>;
+	/** Get details for a specific entity type. */
+	getType(typeName: string): Promise<Record<string, unknown>>;
+	/** List all attributes. */
+	getAttributes(): Promise<Record<string, unknown>[]>;
+	/** Get details for a specific attribute. */
+	getAttribute(attrName: string): Promise<Record<string, unknown>>;
+	/** Query temporal entities. */
+	getTemporalEntities(params?: GetTemporalEntitiesParams): Promise<Record<string, unknown>[]>;
+	/** Get temporal representation of a single entity. */
+	getTemporalEntity(entityId: string): Promise<Record<string, unknown>>;
+	/** Create multiple entities in a single request. */
+	batchCreate(entities: Record<string, unknown>[]): Promise<Record<string, unknown>>;
+	/** Upsert multiple entities in a single request. */
+	batchUpsert(entities: Record<string, unknown>[]): Promise<Record<string, unknown>>;
+	/** Update multiple entities in a single request. */
+	batchUpdate(entities: Record<string, unknown>[]): Promise<Record<string, unknown>>;
+	/** Delete multiple entities by ID. */
+	batchDelete(entityIds: string[]): Promise<Record<string, unknown>>;
+	/** GET request that returns parsed JSON or throws. */
+	private _jsonGet;
+	/** POST request that returns parsed JSON or throws. */
+	private _jsonPost;
+	/**
+	 * Make an authenticated API request.
+	 * Automatically checks response status, parses JSON, and throws on error.
+	 *
+	 * Empty bodies (`Content-Length: 0` 含む) は Content-Type に関係なく `null`
+	 * を返す (#1145)。NGSI-LD の POST / DELETE / PATCH 系は仕様上ボディが
+	 * 空だが、サーバ実装が `Content-Type: application/ld+json` を付けて返す
+	 * ケースがあり、そこで `res.json()` が SyntaxError を投げて止まっていた。
+	 */
+	request(method: string, path: string, body?: unknown): Promise<unknown>;
+	/**
+	 * Make an authenticated API request and return the raw Response object.
+	 * Use this when you need access to response headers (e.g. NGSILD-Results-Count).
+	 */
+	requestRaw(method: string, path: string, body?: unknown): Promise<Response>;
+	/** Establish WebSocket connection (authentication is automatic). */
+	connect(): Promise<void>;
+	/** Force-reconnect (closes existing connection, preserves subscriptions). */
+	reconnect(): Promise<void>;
+	/** Disconnect WebSocket (does not fire 'disconnected' event). */
+	disconnect(): void;
+	/** Check if WebSocket is currently open. */
+	isConnected(): boolean;
+	/** Subscribe to entity events (can be called before or after connect). */
+	subscribe(options?: SubscribeOptions): void;
+}
+/**
+ * NGSI-LD and GeoJSON types for the ./react subpath.
+ */
+export interface GeoJsonPoint {
+	type: "Point";
+	coordinates: [
+		number,
+		number
+	];
+}
+export interface GeoJsonPolygon {
+	type: "Polygon";
+	coordinates: number[][][];
+}
+export type GeoJsonGeometry = GeoJsonPoint | GeoJsonPolygon;
+/** NGSI-LD Property */
+export interface LdProperty {
+	type: "Property";
+	value: string | number | boolean | null;
+	observedAt?: string;
+}
+/** NGSI-LD GeoProperty */
+export interface LdGeoProperty {
+	type: "GeoProperty";
+	value: GeoJsonGeometry;
+	observedAt?: string;
+}
+/** NGSI-LD Relationship */
+export interface LdRelationship {
+	type: "Relationship";
+	object: string;
+	observedAt?: string;
+}
+export type LdAttribute = LdProperty | LdGeoProperty | LdRelationship;
+/** NGSI-LD Entity */
+export interface LdEntity {
+	id: string;
+	type: string;
+	[key: string]: string | LdAttribute | undefined;
+}
+/** Options for querying NGSI-LD entities */
+export interface LdQueryOptions {
+	type?: string;
+	limit?: number;
+	attrs?: string[];
+	q?: string;
+	scopeQ?: string;
+}
+/** NGSIv2 Entity for map display */
+export interface NgsiEntity {
+	id: string;
+	type: string;
+	[key: string]: string | NgsiAttribute | undefined;
+}
+export interface NgsiAttribute {
+	type: string;
+	value: string | number | boolean | object | null;
+}
+/**
+ * Fetch NGSI-LD entities using the GeonicDB SDK client.
+ *
+ * The official SDK core handles DPoP / auth transparently.
+ */
+export declare function useLdEntities(client: GeonicDB, options?: LdQueryOptions): {
+	entities: LdEntity[];
+	loading: boolean;
+	error: Error | null;
+	refetch: () => Promise<void>;
+};
+/**
+ * Fetch NGSI-LD temporal (time-series) data using the GeonicDB SDK client.
+ */
+export declare function useTemporalData(client: GeonicDB | undefined, options: GetTemporalEntitiesParams & {
+	enabled?: boolean;
+}): {
+	data: Record<string, unknown>[];
+	loading: boolean;
+	error: Error | null;
+	refetch: () => Promise<void>;
+};
+export interface GeonicDbMapProps {
+	center?: [
+		number,
+		number
+	];
+	zoom?: number;
+	styleUrl?: string;
+	/** Entities to display. Accepts both LdEntity (NGSI-LD) and NgsiEntity (NGSIv2). */
+	entities?: (LdEntity | NgsiEntity)[];
+	onEntityClick?: (entity: LdEntity | NgsiEntity) => void;
+	onMapClick?: (lngLat: [
+		number,
+		number
+	]) => void;
+	className?: string;
+	style?: CSSProperties;
+	showPopups?: boolean;
+	fitToMarkers?: boolean;
+}
+export declare function GeonicDbMap({ center, zoom, styleUrl, entities, onEntityClick, onMapClick, className, style: customStyle, showPopups, fitToMarkers, }: GeonicDbMapProps): import("react").JSX.Element;
+
+export {};