@geolonia/geonicdb-sdk 0.16.0 → 0.17.0

package/geonicdb.mjs

@@ -1210,13 +1210,12 @@ var _AuthManager = class _AuthManager {
     }
     const url = this._baseUrl + path;
     const isDPoP = this._tokenType === "DPoP" && !!this._dpopKeyPair && token !== null;
-    const isEntityWrite = path.split("?")[0].startsWith("/ngsi-ld/v1/entities");
+    const pathname = path.split("?")[0];
+    const isNgsiLdWrite = pathname.startsWith("/ngsi-ld/v1/") && pathname !== "/ngsi-ld/v1/jsonldContexts";
+    const withCoreContext = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && !("@context" in value) ? { ...value, "@context": NGSI_LD_CORE_CONTEXT } : value;
     let effectiveBody = body;
-    if (isEntityWrite && effectiveBody !== null && typeof effectiveBody === "object" && !Array.isArray(effectiveBody) && !("@context" in effectiveBody)) {
-      effectiveBody = {
-        ...effectiveBody,
-        "@context": NGSI_LD_CORE_CONTEXT
-      };
+    if (isNgsiLdWrite && effectiveBody !== void 0) {
+      effectiveBody = Array.isArray(effectiveBody) ? effectiveBody.map(withCoreContext) : withCoreContext(effectiveBody);
     }
     const bodyStr = effectiveBody !== void 0 ? JSON.stringify(effectiveBody) : void 0;
     const doRequest = async (reqToken, dpopNonce) => {
@@ -1362,6 +1361,7 @@ var WebSocketManager = class {
       if (options.entityTypes) msg.entityTypes = options.entityTypes;
       if (options.idPattern) msg.idPattern = options.idPattern;
       if (options.scopeQ) msg.scopeQ = options.scopeQ;
+      if (options["@context"]) msg["@context"] = options["@context"];
     }
     this._subscription = msg;
     if (this._pendingSubscription) return;
@@ -1429,6 +1429,10 @@ var WebSocketManager = class {
           return;
         }
         if (msg.type === "pong") return;
+        if (msg.type === "subscribed") {
+          this._emit("subscribed", void 0);
+          return;
+        }
         if (msg.type === "dpop_verified") {
           this._pendingSubscription = false;
           if (this._subscription) {
@@ -1895,7 +1899,9 @@ var GeonicDB = class extends EventEmitter {
       limit: 0,
       type: params?.type,
       q: params?.q,
-      scopeQ: params?.scopeQ
+      scopeQ: params?.scopeQ,
+      // #2278: clause 5.7.2.4 の "too wide query" 免除条件 (e) local scope。
+      local: params?.local
     });
     const res = await this._auth.request("GET", path);
     if (!res.ok) {
@@ -1992,7 +1998,21 @@ var GeonicDB = class extends EventEmitter {
       "Batch create failed"
     );
   }
-  /** Upsert multiple entities in a single request. */
+  /**
+   * Upsert multiple entities in a single request.
+   *
+   * #1742: the server follows ETSI GS CIM 009 clause 5.6.8.5 / Table 6.15.3.1-1:
+   *  - **201** with a `string[]` of the **created** entity IDs, when at least one entity
+   *    was newly created and none failed (merely updated entities are not listed);
+   *  - **204** with no body, when every entity already existed and was updated
+   *    (`_jsonPost` maps this to `{}`);
+   *  - **207** with a `BatchOperationResult` (`{ created, updated, errors }`), on partial
+   *    or total failure.
+   *
+   * The return type reflects all three shapes. Narrow with `Array.isArray(result)` to
+   * detect the "something was created" case.
+   * https://cim.etsi.org/NGSI-LD/official/clause-6.html
+   */
   async batchUpsert(entities) {
     return this._jsonPost(
       "/ngsi-ld/v1/entityOperations/upsert",