@geolonia/geonicdb-sdk 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geolonia/geonicdb-sdk",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "GeonicDB JavaScript SDK — NGSI-LD Context Broker client for browser and Node.js",
   "main": "geonicdb.cjs",
   "module": "geonicdb.mjs",

package/react/index.d.ts

@@ -42,6 +42,18 @@ export interface GeonicDBOptions {
 	 */
 	anonymous?: boolean;
 }
+/**
+ * Options for {@link GeonicDB.request} and `requestRaw` (#3322).
+ *
+ * `headers` overrides the SDK defaults `Content-Type` / `Accept`
+ * (header names are matched case-insensitively; the caller's spelling is sent).
+ * `Authorization`, `DPoP`, `Fiware-Service`, and `NGSILD-Tenant` (any casing)
+ * are reserved and throw `TypeError` — the SDK sets those itself.
+ * A GET or HEAD that includes `headers` skips the ETag cache and in-flight dedup.
+ */
+export interface RequestOptions {
+	headers?: Record<string, string>;
+}
 /** Options for the SDK polling helper. */
 export interface PollOptions<T = unknown> {
 	/** Polling interval in milliseconds (default: 5000). */
@@ -660,12 +672,12 @@ declare class GeonicDB extends EventEmitter {
 	 * 空だが、サーバ実装が `Content-Type: application/ld+json` を付けて返す
 	 * ケースがあり、そこで `res.json()` が SyntaxError を投げて止まっていた。
 	 */
-	request(method: string, path: string, body?: unknown): Promise<unknown>;
+	request(method: string, path: string, body?: unknown, options?: RequestOptions): 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>;
+	requestRaw(method: string, path: string, body?: unknown, options?: RequestOptions): Promise<Response>;
 	/** Establish WebSocket connection (authentication is automatic). */
 	connect(): Promise<void>;
 	/** Force-reconnect (closes existing connection, preserves subscriptions). */