@geolonia/geonicdb-sdk 0.13.0 → 0.15.0

package/README.md

@@ -115,6 +115,30 @@ On runtimes without Web Crypto (`subtle.generateKey`, e.g. a non-HTTPS
 context), the session cannot be sender-constrained: the SDK silently keeps
 the plain Bearer session and **login still succeeds** (`tokenType === 'Bearer'`).
 
+#### First-login forced password change (#1532)
+
+When an administrator issues a **temporary password** — either at creation
+(`POST /admin/users` with `passwordResetRequired: true`) or afterwards
+(`POST /admin/users/{userId}/reset-password`) — the user must set a new password
+on first login. Logging in with only the temporary password throws
+`PasswordResetRequiredError`; supply `newPassword` to set the new password and
+receive tokens in the same call (no re-login needed):
+
+```typescript
+import { PasswordResetRequiredError, TemporaryPasswordExpiredError } from '@geolonia/geonicdb-sdk';
+
+try {
+  await db.login('user@example.com', temporaryPassword);
+} catch (err) {
+  if (err instanceof PasswordResetRequiredError) {
+    // Prompt the user for a new password, then complete login in one call:
+    await db.login('user@example.com', temporaryPassword, { newPassword });
+  } else if (err instanceof TemporaryPasswordExpiredError) {
+    // Ask an administrator to re-issue the temporary password.
+  }
+}
+```
+
 #### Keeping the user signed in across page reloads
 
 By default a session is held in memory only — reloading the page loses it
@@ -196,6 +220,11 @@ const entities = await db.getEntities({ type: 'GeoJSON' });
 
 ## Entity CRUD
 
+> **Automatic `@context` (#1583)**: the SDK sends requests as `application/ld+json`,
+> which requires an inline JSON-LD `@context` in the body. When your body omits
+> `@context`, the SDK injects the NGSI-LD core context automatically; a
+> `@context` you provide is always preserved (never overwritten).
+
 ```typescript
 // Create
 await db.createEntity({ id: 'urn:ngsi-ld:Room:001', type: 'Room', ... });
@@ -633,12 +662,39 @@ const rooms = await client.getEntities({ type: 'Room', limit: 20 });
 | Method | Description |
 |--------|-------------|
 | `createNgsiV2Client(config)` | `NgsiV2Client` を生成。`config`: `baseUrl`（必須）/ `apiKey` / `service` |
-| `getEntities(options?)` | エンティティ一覧（`type` / `q` / `limit` / `offset` / `attrs` / `options`） |
+| `getEntities(options?)` | エンティティ一覧（`type` / `q` / `limit` / `offset` / `attrs` / `options` / `georel` / `geometry` / `coords`） |
 | `getEntity(id, options?)` | 単一エンティティ取得 |
 | `createEntity(entity)` | エンティティ作成 |
 | `updateEntityAttributes(id, attrs)` | 属性の部分更新 |
 | `deleteEntity(id)` | エンティティ削除 |
 
+### Geospatial query (`georel` / `geometry` / `coords`)
+
+NGSIv2 の地理空間クエリに対応。`georel`・`geometry`・`coords` は 3 つ揃えて指定する（部分指定は Orion 側で `400`）。
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `georel` | `string` | 地理的関係。複合形も可（例: `near;maxDistance:1000`, `coveredBy`） |
+| `geometry` | `'point' \| 'line' \| 'polygon' \| 'box'` | ジオメトリ種別 |
+| `coords` | `string` | WGS84 座標。複数点はセミコロン区切り（例: `35.6,139.7`） |
+
+```ts
+// 指定座標から半径 1km 以内
+const nearby = await client.getEntities({
+  type: 'PublicFacility',
+  georel: 'near;maxDistance:1000',
+  geometry: 'point',
+  coords: '35.6,139.7',
+});
+
+// ポリゴン内に含まれるエンティティ
+const inArea = await client.getEntities({
+  georel: 'coveredBy',
+  geometry: 'polygon',
+  coords: '0,0;1,0;1,1;0,1;0,0',
+});
+```
+
 ## License
 
 MIT

package/geonicdb.cjs

@@ -29,7 +29,9 @@ __export(index_exports, {
   GeonicDBError: () => GeonicDBError,
   NetworkError: () => NetworkError,
   NotFoundError: () => NotFoundError,
+  PasswordResetRequiredError: () => PasswordResetRequiredError,
   RateLimitError: () => RateLimitError,
+  TemporaryPasswordExpiredError: () => TemporaryPasswordExpiredError,
   ValidationError: () => ValidationError,
   buildPathWithParams: () => buildPathWithParams,
   default: () => index_default
@@ -80,6 +82,7 @@ var RECONNECT_MAX_ATTEMPTS = 10;
 var RECONNECT_BASE_MS = 1e3;
 var RECONNECT_MAX_DELAY_MS = 3e4;
 var SUB_PROTOCOL = "access_token";
+var NGSI_LD_CORE_CONTEXT = "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld";
 var SDK_CACHE_MAX_ENTRIES_DEFAULT = 1e3;
 var SDK_POLL_INTERVAL_MS_DEFAULT = 5e3;
 var DPOP_IDB_NAME = "geonicdb-sdk";
@@ -321,6 +324,20 @@ var ConflictError = class extends GeonicDBError {
     this.name = "ConflictError";
   }
 };
+var PasswordResetRequiredError = class extends AuthenticationError {
+  constructor(message = "Password reset required: set a new password to complete login") {
+    super(message);
+    this.name = "PasswordResetRequiredError";
+    this.statusCode = 409;
+  }
+};
+var TemporaryPasswordExpiredError = class extends AuthenticationError {
+  constructor(message = "Temporary password expired: ask an administrator to re-issue it") {
+    super(message);
+    this.name = "TemporaryPasswordExpiredError";
+    this.statusCode = 403;
+  }
+};
 var ValidationError = class extends GeonicDBError {
   constructor(message = "Validation failed") {
     super(message, 422);
@@ -711,16 +728,24 @@ var _AuthManager = class _AuthManager {
       "Content-Type": "application/json"
     };
     if (this._tenant) headers["NGSILD-Tenant"] = this._tenant;
+    const loginBody = { email, password };
+    if (options?.newPassword !== void 0) loginBody.newPassword = options.newPassword;
     const res = await fetch(this._baseUrl + "/auth/login", {
       method: "POST",
       headers,
-      body: JSON.stringify({ email, password })
+      body: JSON.stringify(loginBody)
     });
     if (!res.ok) {
       const e = await res.json().catch(() => ({}));
-      throw new AuthenticationError(
-        e.detail || e.description || "Login failed: " + res.status
-      );
+      const message = e.detail || e.description || "Login failed: " + res.status;
+      const code = e.error || e.type || e.title || "";
+      if (res.status === 409 && code.includes("PasswordResetRequired")) {
+        throw new PasswordResetRequiredError(message);
+      }
+      if (res.status === 403 && code.includes("TemporaryPasswordExpired")) {
+        throw new TemporaryPasswordExpiredError(message);
+      }
+      throw new AuthenticationError(message);
     }
     const data = await res.json();
     this._anonymous = false;
@@ -1221,7 +1246,15 @@ var _AuthManager = class _AuthManager {
     }
     const url = this._baseUrl + path;
     const isDPoP = this._tokenType === "DPoP" && !!this._dpopKeyPair && token !== null;
-    const bodyStr = body !== void 0 ? JSON.stringify(body) : void 0;
+    const isEntityWrite = path.split("?")[0].startsWith("/ngsi-ld/v1/entities");
+    let effectiveBody = body;
+    if (isEntityWrite && effectiveBody !== null && typeof effectiveBody === "object" && !Array.isArray(effectiveBody) && !("@context" in effectiveBody)) {
+      effectiveBody = {
+        ...effectiveBody,
+        "@context": NGSI_LD_CORE_CONTEXT
+      };
+    }
+    const bodyStr = effectiveBody !== void 0 ? JSON.stringify(effectiveBody) : void 0;
     const doRequest = async (reqToken, dpopNonce) => {
       const reqIsDPoP = this._tokenType === "DPoP" && !!this._dpopKeyPair && reqToken !== null;
       const dpopProof = reqIsDPoP ? await createDPoPProof(